summaryrefslogtreecommitdiffstats
path: root/docs/sections
diff options
context:
space:
mode:
authorMorgan Richomme <morgan.richomme@orange.com>2017-10-18 16:30:40 +0200
committerMorgan Richomme <morgan.richomme@orange.com>2017-10-19 08:09:46 +0200
commitc1dd7238385020a6b814dd550a399d8ed6e09df3 (patch)
tree6739c61a6b01332ad94c822a8847e9b736a01743 /docs/sections
parent914778def3d2c6625c3e471b0f7a9f504d5d8e3f (diff)
clean dcae doc repo
* fix doc8 in dcaecdap.rst * rm all non dcae related rst in api examples dcaecdap.rst repo will be removed from doc repo to avoid source duplication the file will be only cross referenced from doc JIRA: DOC-107 Change-Id: I7745a26b223a472ba76f7c656b0889ada0c16102 Signed-off-by: Morgan Richomme <morgan.richomme@orange.com>
Diffstat (limited to 'docs/sections')
-rw-r--r--docs/sections/apiexample/dcaecdap.rst759
-rw-r--r--docs/sections/apiexample/httpdomain.rst10
-rw-r--r--docs/sections/apiexample/swagger2markup.rst24
-rw-r--r--docs/sections/apiexample/swaggerv2doc.rst11
-rw-r--r--docs/sections/apiexample/vfcexample.rst768
-rw-r--r--docs/sections/apiexample/worddoc2rst.rst11
6 files changed, 332 insertions, 1251 deletions
diff --git a/docs/sections/apiexample/dcaecdap.rst b/docs/sections/apiexample/dcaecdap.rst
index bc7f7bf3..16dc2cf4 100644
--- a/docs/sections/apiexample/dcaecdap.rst
+++ b/docs/sections/apiexample/dcaecdap.rst
@@ -30,13 +30,12 @@ shows some information about this service
Responses
~~~~~~~~~
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | successful response | `info <#_info> |
-| | | `__ |
-+---------+----------------------------------------------------+----------------+
++---------+--------------------------------------------+-------------------+
+| HTTP | Description | Schema |
+| Code | | |
++=========+============================================+===================+
+| **200** | successful response | `info <#_info>`__ |
++---------+--------------------------------------------+-------------------+
GET /application
----------------
@@ -49,18 +48,17 @@ get all applications registered with this broker
Responses
~~~~~~~~~
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | successful response | < |
-| | | `appname <#_ap |
-| | | pname>`__ |
-| | | > array |
-+---------+----------------------------------------------------+----------------+
++---------+-------------------------------------------+---------------+
+| HTTP | Description | Schema |
+| Code | | |
++=========+===========================================+===============+
+| **200** | successful response | `appname <#_a |
+| | | ppname>`__ |
+| | | (array) |
++---------+-------------------------------------------+---------------+
-PUT /application\*/{appname}
-----------------------------
+PUT /application/{appname}
+--------------------------
Description
~~~~~~~~~~~
@@ -77,34 +75,31 @@ assumed to also be the key in consul.
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **appname | Name of the application. | string (text) |
-| * | ** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Body* | | **putbody | required put body | `hydratorappput |
-| * | ** | | <#_hydratorapppu |
-| | | *required | | t>`__ |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+---------------+---------------------------------+------------------+
+| Type | Name | Description | Schema |
++==========+===============+=================================+==================+
+| **Path** | | **appname** | Name of the application. | string (text) |
+| | | *required* | | |
++----------+---------------+---------------------------------+------------------+
+| **Body** | | **putbody** | required put body | `hydratorappput |
+| | | *required* | | <#_hydratorapppu |
+| | | | t>`__ |
++----------+---------------+---------------------------------+------------------+
Responses
~~~~~~~~~
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | Successful response | `Application < |
-| | | #_application> |
-| | | `__ |
-+---------+----------------------------------------------------+----------------+
-| **400** | put was performed but the appname was already | No Content |
-| | registered with the broker, or Invalid PUT body | |
-+---------+----------------------------------------------------+----------------+
++---------+----------------------------------------------------+---------------+
+| HTTP | Description | Schema |
+| Code | | |
++=========+====================================================+===============+
+| **200** | Successful response | `application |
+| | | <#_applicatio |
+| | | n>`__ |
++---------+----------------------------------------------------+---------------+
+| **400** | put was performed but the appname was already | No Content |
+| | registered with the broker, or Invalid PUT body | |
++---------+----------------------------------------------------+---------------+
Consumes
~~~~~~~~
@@ -129,28 +124,25 @@ DELETE(application/i)
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Body* | | **postbod | required post body | `multideleteput |
-| * | y** | | <#_multideletepu |
-| | | *required | | t>`__ |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+----------------+------------------------------+------------------+
+| Type | Name | Description | Schema |
++==========+================+==============================+==================+
+| **Body** | | **postbody** | required post body | `multideleteput |
+| | | *required* | | <#_multideletepu |
+| | | | t>`__ |
++----------+----------------+------------------------------+------------------+
Responses
~~~~~~~~~
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | successful response | < |
-| | | `returncode <# |
-| | | _returncode>`_ |
-| | | _ |
-| | | > array |
-+---------+----------------------------------------------------+----------------+
++---------+----------------------------------------------+-------------------+
+| HTTP | Description | Schema |
+| Code | | |
++=========+==============================================+===================+
+| **200** | successful response | `returncode |
+| | | <#_returncode>`__ |
+| | | (array) |
++---------+----------------------------------------------+-------------------+
GET /application/{appname}
--------------------------
@@ -164,29 +156,27 @@ links for healthcheck and metrics.
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **appname | Name of the application. | string (text) |
-| * | ** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+---------------+--------------------------------+------------------+
+| Type | Name | Description | Schema |
++==========+===============+================================+==================+
+| **Path** | | **appname** | Name of the application. | string (text) |
+| | | *required* | | |
++----------+---------------+--------------------------------+------------------+
Responses
~~~~~~~~~
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | Successful response | `Application < |
-| | | #_application> |
-| | | `__ |
-+---------+----------------------------------------------------+----------------+
-| **404** | no app with name 'appname' registered with this | No Content |
-| | broker. | |
-+---------+----------------------------------------------------+----------------+
++---------+----------------------------------------------------+---------------+
+| HTTP | Description | Schema |
+| Code | | |
++=========+====================================================+===============+
+| **200** | Successful response | `application |
+| | | <#_applicatio |
+| | | n>`__ |
++---------+----------------------------------------------------+---------------+
+| **404** | no app with name 'appname' registered with this | No Content |
+| | broker. | |
++---------+----------------------------------------------------+---------------+
PUT /application/{appname}
--------------------------
@@ -201,34 +191,30 @@ also be the key in consul.
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **appname | Name of the application. | string (text) |
-| * | ** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Body* | | **putbody | required put body | `appput <#_apppu |
-| * | ** | | t>`__ |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+---------------+--------------------------------+------------------+
+| Type | Name | Description | Schema |
++==========+===============+================================+==================+
+| **Path** | | **appname** | Name of the application. | string (text) |
+| | | *required* | | |
++----------+---------------+--------------------------------+------------------+
+| **Body** | | **putbody** | required put body | `appput <#_apppu |
+| | | *required* | | t>`__ |
++----------+---------------+--------------------------------+------------------+
Responses
~~~~~~~~~
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | Successful response | `Application < |
-| | | #_application> |
-| | | `__ |
-+---------+----------------------------------------------------+----------------+
-| **400** | put was performed but the appname was already | No Content |
-| | registered with the broker, or Invalid PUT body | |
-+---------+----------------------------------------------------+----------------+
++---------+--------------------------------------------------+---------------+
+| HTTP | Description | Schema |
+| Code | | |
++=========+==================================================+===============+
+| **200** | Successful response | `Application |
+| | | <#_applicatio |
+| | | n>`__ |
++---------+--------------------------------------------------+---------------+
+| **400** | put was performed but the appname was already | No Content |
+| | registered with the broker, or Invalid PUT body | |
++---------+--------------------------------------------------+---------------+
Consumes
~~~~~~~~
@@ -252,14 +238,12 @@ the metrics and health endpoints for this app.
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **appname | Name of the application. | string (text) |
-| * | ** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+---------------+--------------------------------+------------------+
+| Type | Name | Description | Schema |
++==========+===============+================================+==================+
+| **Path** | | **appname** | Name of the application. | string (text) |
+| | | *required* | | |
++----------+---------------+--------------------------------+------------------+
Responses
~~~~~~~~~
@@ -285,14 +269,12 @@ Perform a healthcheck on the running app appname.
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **appname | Name of the application to get the | string (test) |
-| * | ** | healthcheck for. | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+---------------+--------------------------------+------------------+
+| Type | Name | Description | Schema |
++==========+===============+================================+==================+
+| **Path** | | **appname** | Name of the application to get | string (text) |
+| | | *required* | the healthcheck for. | |
++----------+---------------+--------------------------------+------------------+
Responses
~~~~~~~~~
@@ -321,14 +303,12 @@ Metrics are customized per each app by the component developer
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **appname | Name of the application to get | string (test) |
-| * | ** | metrics for. | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+---------------+--------------------------------+------------------+
+| Type | Name | Description | Schema |
++==========+===============+================================+==================+
+| **Path** | | **appname** | Name of the application to get | string (text) |
+| | | *required* | metrics for. | |
++----------+---------------+--------------------------------+------------------+
Responses
~~~~~~~~~
@@ -338,8 +318,8 @@ Responses
| Code | | |
+=========+====================================================+================+
| **200** | Successful response | `MetricsObject |
-| | | <#_metricsobj |
-| | | ect>`__ |
+| | | <#_metricsobje |
+| | | ct>`__ |
+---------+----------------------------------------------------+----------------+
| **404** | no app with name 'appname' registered with this | No Content |
| | broker. | |
@@ -356,19 +336,15 @@ Reconfigures the application.
Parameters
~~~~~~~~~~
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **appname | Name of the application. | string (text) |
-| * | ** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Body* | | **putbody | required put body | `reconfigput <#_ |
-| * | ** | | reconfigput>`__ |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
++----------+---------------+----------------------------+--------------------+
+| Type | Name | Description | Schema |
++==========+===============+============================+====================+
+| **Path** | | **appname** | Name of the application. | string (text) |
+| | | *required* | | |
++----------+---------------+----------------------------+--------------------+
+| **Body** | | **putbody** | required put body | `reconfigput |
+| | | *required* | | <#_reconfigput>`__ |
++----------+---------------+----------------------------+--------------------+
Responses
~~~~~~~~~
@@ -392,39 +368,29 @@ Definitions
Application
-----------
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **appname | application name | string |
-| ** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **connect | input URL that you can POST data into (URL | string |
-| ionurl** | of the CDAP stream) | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **healthc | fully qualified url to perform healthcheck | string |
-| heckurl** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **metrics | fully qualified url to get metrics from | string |
-| url** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **service | a list of HTTP services exposed by this | < |
-| endpoints** | CDAP application | `service\_method |
-| | *optional | | <#_service_meth |
-| * | | od>`__ |
-| | | > array |
-+-------------+---------------------------------------------+------------------+
-| | **url** | fully qualified url of the resource | string |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++---------------------+---------------------------------------------+------------------+
+| Name | Description | Schema |
++=====================+=============================================+==================+
+| | **appname** | application name | string |
+| | *optional* | | |
++---------------------+---------------------------------------------+------------------+
+| | **connectionurl** | input URL that you can POST data into (URL | string |
+| | *optional* | of the CDAP stream) | |
++---------------------+---------------------------------------------+------------------+
+| | **healthcheckurl**| fully qualified url to perform healthcheck | string |
+| | *optional* | | |
++---------------------+---------------------------------------------+------------------+
+| | **metricsurl** | fully qualified url to get metrics from | string |
+| | *optional* | | |
++---------------------+---------------------------------------------+------------------+
+| | **service | a list of HTTP services exposed by this | `service\_method |
+| endpoints** | CDAP application | <#_service_metho |
+| | *optional* | | d>`__ |
+| | | (array) |
++---------------------+---------------------------------------------+------------------+
+| | **url** | fully qualified url of the resource | string |
+| | *optional* | | |
++---------------------+---------------------------------------------+------------------+
MetricsObject
-------------
@@ -449,261 +415,210 @@ an application name
appput
------
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **app\_co | the application config JSON | object |
-| nfig** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **app\_pr | the application preferences JSON | object |
-| eferences** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **artifac | the name of the CDAP artifact to be added | string |
-| t\_name** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **cdap\_a | denotes whether this is a program-flowlet | enum |
-| pplication\ | style application or a hydrator pipeline. | (program-flowlet |
-| _type** | For program-flowlet style apps, this value | ) |
-| | *optional | must be "program-flowlet" | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **jar\_ur | the URL that the JAR you’re deploying | string |
-| l** | resides | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **namespa | the cdap namespace this is deployed into | string |
-| ce** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **program | | < |
-| \_preferenc | | `programpref <#_ |
-| es** | | programpref>`__ |
-| | *optional | | > array |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **program | | < |
-| s** | | `programs <#_pro |
-| | *optional | | grams>`__ |
-| * | | > array |
-+-------------+---------------------------------------------+------------------+
-| | **service | | < |
-| s** | | `service\_endpoi |
-| | *optional | | nt <#_service_en |
-| * | | dpoint>`__ |
-| | | > array |
-+-------------+---------------------------------------------+------------------+
-| | **streamn | name of the CDAP stream to ingest data into | string |
-| ame** | this app. Should come from the developer | |
-| | *optional | and Tosca model. | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++-------------------------------+---------------------------------------------+--------------------+
+| Name | Description | Schema |
++===============================+=============================================+====================+
+| | **app\_config** | the application config JSON | object |
+| | *optional* | | |
++-------------------------------+---------------------------------------------+--------------------+
+| | **app\_preferences** | the application preferences JSON | object |
+| | *optional* | | |
++-------------------------------+---------------------------------------------+--------------------+
+| | **artifact\_name** | the name of the CDAP artifact to be added | string |
+| | *optional* | | |
++-------------------------------+---------------------------------------------+--------------------+
+| | **cdap\_application\_type** | denotes whether this is a program-flowlet | enum |
+| | *optional* | style application or a hydrator pipeline. | (program-flowlet |
+| | For program-flowlet style apps, this value | ) |
+| | must be "program-flowlet" | |
++-------------------------------+---------------------------------------------+--------------------+
+| | **jar\_url** | the URL that the JAR you’re deploying | string |
+| | *optional* | resides | |
++-------------------------------+---------------------------------------------+--------------------+
+| | **namespace** | the cdap namespace this is deployed into | string |
+| | *optional* | | |
++-------------------------------+---------------------------------------------+--------------------+
+| | **program\_preferences** | | `programpref |
+| | *optional* | | <#_programpref>`__ |
+| | | (array) |
++-------------------------------+---------------------------------------------+--------------------+
+| | **programs** | | `programs |
+| | *optional* | | <#_programs>`__ |
+| | | (array) |
++-------------------------------+---------------------------------------------+--------------------+
+| | **services** | | `service\_endpoint |
+| | *optional* | | <#_service_endpoin |
+| | | t>`__ (array) |
++-------------------------------+---------------------------------------------+--------------------+
+| | **streamname** | name of the CDAP stream to ingest data into | string |
+| | *optional* | this app. Should come from the developer | |
+| | and Tosca model. | |
++-------------------------------+---------------------------------------------+--------------------+
hydratorappput
--------------
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **cdap\_a | denotes whether this is a program-flowlet | enum |
-| pplication\ | style application or a hydrator pipeline. | (hydrator-pipeli |
-| _type** | For hydrator, this value must be | ne) |
-| | *required | "hydrator-pipeline" | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **depende | represents a list of dependencies to be | < |
-| ncies** | loaded for this pipeline. Not required. | `hydratordep <#_ |
-| | *optional | | hydratordep>`__ |
-| * | | > array |
-+-------------+---------------------------------------------+------------------+
-| | **namespa | the cdap namespace this is deployed into | string |
-| ce** | | |
-| | *required | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **pipelin | the URL of the config.json for this | string |
-| e\_config\_ | pipeline | |
-| json\_url** | | |
-| | *required | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **streamn | name of the CDAP stream to ingest data into | string |
-| ame** | this app. Should come from the developer | |
-| | *required | and Tosca model. | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++-----------------------------------+---------------------------------------------+---------------+
+| Name | Description | Schema |
++===================================+=============================================+===============+
+| | **cdap\_application\_TYPE** | denotes whether this is a program-flowlet | enum |
+| | style application or a hydrator pipeline. | (hydrator-pip |
+| | *required* | For hydrator, this value must be | eline) |
+| | "hydrator-pipeline" | |
++-----------------------------------+---------------------------------------------+---------------+
+| | **dependencies** | represents a list of dependencies to be | `hydratordep |
+| | *optional* | loaded for this pipeline. Not required. | <#_hydratorde |
+| | | p>`__ (array) |
++-----------------------------------+---------------------------------------------+---------------+
+| | **namespace** | the cdap namespace this is deployed into | string |
+| | *required* | | |
++-----------------------------------+---------------------------------------------+---------------+
+| | **pipeline\_config\_json\_url** | the URL of the config.json for this | string |
+| | *required* | pipeline | |
++-----------------------------------+---------------------------------------------+---------------+
+| | **streamname** | name of the CDAP stream to ingest data into | string |
+| | *required* | this app. Should come from the developer | |
+| | and Tosca model. | |
++-----------------------------------+---------------------------------------------+---------------+
hydratordep
-----------
-represents a hydrator pipeline dependency. An equivelent to the
-following CURLs are formed with the below four params shown in CAPS
-"curl -v -w"\\n" -X POST
-http://cdapurl:11015/v3/namespaces/setelsewhere/artifacts/ARTIFACT_NAME
--H "Artifact-Extends:ARTIFACT\_EXTENDS\_HEADER" -H
-“Artifact-Version:ARTIFACT\_VERSION\_HEADER” –data-binary @(DOWNLOADED
-FROM ARTIFACT\_URL)","curl -v -w"\\n" -X PUT
-http://cdapurl:11015/v3/namespaces/setelsewhere/artifacts/ARTIFACT_NAME/versions/ARTIFACT_VERSION_HEADER/properties
--d (DOWNLOADED FROM UI\_PROPERTIES\_URL)"
-
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **artifac | the value of the header that gets passed in | string |
-| t\_extends\ | for artifact-extends, e.g., | |
-| _header** | "Artifact-Extends:system:cdap-data-pipeline | |
-| | *required | [4.0.1,5.0.0)" | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **artifac | the name of the artifact | string |
-| t\_name** | | |
-| | *required | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **artifac | the URL of the artifact JAR | string |
-| t\_url** | | |
-| | *required | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **artifac | the value of the header that gets passed in | string |
-| t\_version\ | for artifact-version, e.g., | |
-| _header** | "Artifact-Version:1.0.0-SNAPSHOT" | |
-| | *required | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **ui\_pro | the URL of the properties.json if the | string |
-| perties\_ur | custom artifact has UI properties. This is | |
-| l** | optional. | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
+represents a hydrator pipeline dependency. An equivalent to the
+following CURLs are formed with the below four params shown in CAPS::
+
+ curl -v -w"\\n" -X POST
+ http://cdapurl:11015/v3/namespaces/setelsewhere/artifacts/ARTIFACT_NAME
+ -H "Artifact-Extends:ARTIFACT\_EXTENDS\_HEADER" -H
+ “Artifact-Version:ARTIFACT\_VERSION\_HEADER” –data-binary @(DOWNLOADED
+ FROM ARTIFACT\_URL)","curl -v -w"\\n" -X PUT
+ http://cdapurl:11015/v3/namespaces/setelsewhere/artifacts/ARTIFACT_NAME/versions/ARTIFACT_VERSION_HEADER/properties
+ -d (DOWNLOADED FROM UI\_PROPERTIES\_URL)"
+
++---------------------------------+---------------------------------------------+----------+
+| Name | Description | Schema |
++=================================+=============================================+==========+
+| | **artifact\_extends\_header** | the value of the header that gets passed in | string |
+| | *required* | for artifact-extends, e.g., | |
+| | "Artifact-Extends:system:cdap-data-pipeline | |
+| | [4.0.1,5.0.0)" | |
++---------------------------------+---------------------------------------------+----------+
+| | **artifact\_name** | the name of the artifact | string |
+| | *required* | | |
++---------------------------------+---------------------------------------------+----------+
+| | **artifact\_url** | the URL of the artifact JAR | string |
+| | *required* | | |
++---------------------------------+---------------------------------------------+----------+
+| | **artifact\_version\_header** | the value of the header that gets passed in | string |
+| | *required* | for artifact-version, e.g., | |
+| | "Artifact-Version:1.0.0-SNAPSHOT" | |
++---------------------------------+---------------------------------------------+----------+
+| | **ui\_properties\_url** | the URL of the properties.json if the | string |
+| | *optional* | custom artifact has UI properties. This is | |
+| | optional. | |
++---------------------------------+---------------------------------------------+----------+
info
----
some broker information
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **broker | the API version of this running broker | string |
-| API | | |
-| version** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **cdap | The GUI port of the CDAP cluster this | integer |
-| GUI | broker is managing. Mostly to help users of | |
-| port** | this API check their application in cdap. | |
-| | *optional | Note, will return UNKNOWN\_CDAP\_VERSION if | |
-| * | it cannot be determined. | |
-+-------------+---------------------------------------------+------------------+
-| | **cdap | the version of the CDAP cluster this broker | string |
-| cluster | is managing. Note, will return | |
-| version** | UKNOWN\_CDAP\_VERSION if it cannot be | |
-| | *optional | determined. | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **managed | the url of the CDAP cluster API this broker | string |
-| cdap | is managing | |
-| url** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **number | | integer |
-| of | | |
-| applicati | | |
-| ons | | |
-| registere | | |
-| d** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **uptime | | integer |
-| (s)** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++------------------+---------------------------------------------+-----------+
+| Name | Description | Schema |
++==================+=============================================+===========+
+| | **broker API | the API version of this running broker | string |
+| version** | | |
+| | *optional* | | |
++------------------+---------------------------------------------+-----------+
+| | **cdap GUI | The GUI port of the CDAP cluster this | integer |
+| port** | broker is managing. Mostly to help users of | |
+| | *optional* | this API check their application in cdap. | |
+| | Note, will return UNKNOWN\_CDAP\_VERSION if | |
+| | it cannot be determined. | |
++------------------+---------------------------------------------+-----------+
+| | **cdap | the version of the CDAP cluster this broker | string |
+| cluster | is managing. Note, will return | |
+| version** | UKNOWN\_CDAP\_VERSION if it cannot be | |
+| | *optional* | determined. | |
++------------------+---------------------------------------------+-----------+
+| | **managed cdap | the url of the CDAP cluster API this broker | string |
+| url** | is managing | |
+| | *optional* | | |
++------------------+---------------------------------------------+-----------+
+| | **number | | integer |
+| of applications | | |
+| registered** | | |
+| | *optional* | | |
++------------------+---------------------------------------------+-----------+
+| | **uptime (s)** | | integer |
+| | *optional* | | |
++------------------+---------------------------------------------+-----------+
multideleteput
--------------
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **appnames** | < `appname <#_appname>`__ > array |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
++--------------------------------+----------------------------------+
+| Name | Schema |
++================================+==================================+
+| | **appnames** | `appname <#_appname>`__ (array) |
+| | *optional* | |
++--------------------------------+----------------------------------+
programpref
-----------
the list of programs in this CDAP app
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **program | the name of the program | string |
-| \_id** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **program | the preference JSON to set for this program | object |
-| \_pref** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **program | must be one of flows, mapreduce, schedules, | string |
-| \_type** | spark, workflows, workers, or services | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++--------------+---------------------------------------------+----------+
+| Name | Description | Schema |
++==============+=============================================+==========+
+| | **program\ | the name of the program | string |
+| _id** | | |
+| | *optional* | | |
++--------------+---------------------------------------------+----------+
+| | **program_ | the preference JSON to set for this program | object |
+| \pref** | | |
+| | *optional* | | |
++--------------+---------------------------------------------+----------+
+| | **program\ | must be one of flows, mapreduce, schedules, | string |
+| _type** | spark, workflows, workers, or services | |
+| | *optional* | | |
++--------------+---------------------------------------------+----------+
programs
--------
the list of programs in this CDAP app
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **program | the name of the program | string |
-| \_id** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **program | must be one of flows, mapreduce, schedules, | string |
-| \_type** | spark, workflows, workers, or services | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++--------------+---------------------------------------------+-----------+
+| Name | Description | Schema |
++==============+=============================================+===========+
+| | **program\ | the name of the program | string |
+| _id** | | |
+| | *optional* | | |
++--------------+---------------------------------------------+-----------+
+| | **program\ | must be one of flows, mapreduce, schedules, | string |
+| _type** | spark, workflows, workers, or services | |
+| | *optional* | | |
++--------------+---------------------------------------------+-----------+
reconfigput
-----------
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **config* | the config JSON | object |
-| * | | |
-| | *required | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **reconfi | the type of reconfiguration | enum |
-| guration\_t | | (program-flowlet |
-| ype** | | -app-config, |
-| | *required | | program-flowlet- |
-| * | | app-preferences, |
-| | | program-flowlet- |
-| | | smart) |
-+-------------+---------------------------------------------+------------------+
++-----------------------------+-----------------------------+------------------+
+| Name | Description | Schema |
++=============================+=============================+==================+
+| | **config** | the config JSON | object |
+| | *required* | | |
++-----------------------------+-----------------------------+------------------+
+| | **reconfiguration\_type** | the type of reconfiguration | enum |
+| | *required* | | (program-flowlet |
+| | | -app-config, |
+| | | program-flowlet- |
+| | | app-preferences, |
+| | | program-flowlet- |
+| | | smart) |
++-----------------------------+-----------------------------+------------------+
returncode
----------
@@ -718,40 +633,30 @@ service\_endpoint
descirbes a service endpoint, including the service name, the method
name, and the method type (GET, PUT, etc, most of the time will be GET)
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **endpoin | GET, POST, PUT, etc | string |
-| t\_method** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **service | the name of the endpoint on the service | string |
-| \_endpoint* | | |
-| * | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **service | the name of the service | string |
-| \_name** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++--------------------------+-----------------------------------------+---------+
+| Name | Description | Schema |
++==========================+=========================================+=========+
+| | **endpoint\_method** | GET, POST, PUT, etc | string |
+| | *optional* | | |
++--------------------------+-----------------------------------------+---------+
+| | **service\ _endpoint** | the name of the endpoint on the service | string |
+| | *optional* | | |
++--------------------------+-----------------------------------------+---------+
+| | **service\_name** | the name of the service | string |
+| | *optional* | | |
++--------------------------+-----------------------------------------+---------+
service\_method
---------------
a URL and HTTP method exposed via a CDAP service
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **method* | HTTP method you can perform on the URL, | string |
-| * | e.g., GET, PUT, etc | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **url** | the fully qualified URL in CDAP for this | string |
-| | *optional | service | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
++--------------+---------------------------------------------+----------+
+| Name | Description | Schema |
++==============+=============================================+==========+
+| | **method** | HTTP method you can perform on the URL, | string |
+| | *optional* | e.g., GET, PUT, etc | |
++--------------+---------------------------------------------+----------+
+| | **url** | the fully qualified URL in CDAP for this | string |
+| | *optional* | | |
++--------------+---------------------------------------------+----------+
diff --git a/docs/sections/apiexample/httpdomain.rst b/docs/sections/apiexample/httpdomain.rst
deleted file mode 100644
index f06d0067..00000000
--- a/docs/sections/apiexample/httpdomain.rst
+++ /dev/null
@@ -1,10 +0,0 @@
-
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-
-Sphinx httpdomain directive
-===========================
-
-.. http:get:: path
-
- For more information see `<https://pythonhosted.org/sphinxcontrib-httpdomain>`_
-
diff --git a/docs/sections/apiexample/swagger2markup.rst b/docs/sections/apiexample/swagger2markup.rst
deleted file mode 100644
index b83bd4d9..00000000
--- a/docs/sections/apiexample/swagger2markup.rst
+++ /dev/null
@@ -1,24 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-
-
-Swagger2Markup(asciidoc) to Asciidoctor(docbook) to Pandoc(RST)
-===============================================================
-
-vfc-nfvo-lcm
-------------
-
-.. toctree::
- :maxdepth: 1
- :titlesonly:
-
- vfcexample.rst
-
-
-DCAE and YAML intput
---------------------
-
-.. toctree::
- :maxdepth: 1
- :titlesonly:
-
- dcaecdap.rst
diff --git a/docs/sections/apiexample/swaggerv2doc.rst b/docs/sections/apiexample/swaggerv2doc.rst
deleted file mode 100644
index a0f13e06..00000000
--- a/docs/sections/apiexample/swaggerv2doc.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-
-
-
-Sphinx swaggerv2doc directive
------------------------------
-Here is an example of vfc-nfvo-lcm API.
-
-.. swaggerv2doc:: https://gerrit.onap.org/r/gitweb?p=vfc/nfvo/lcm.git;a=blob_plain;f=lcm/swagger/vfc.nslcm.swagger.json
-
-
diff --git a/docs/sections/apiexample/vfcexample.rst b/docs/sections/apiexample/vfcexample.rst
deleted file mode 100644
index 71d3b781..00000000
--- a/docs/sections/apiexample/vfcexample.rst
+++ /dev/null
@@ -1,768 +0,0 @@
-=================================================
-ONAP VFC Network Service Lifecycle Management API
-=================================================
-
-:Date: 2017-10-09
-
-.. contents::
- :depth: 3
-..
-
-Overview
-========
-
-VFC Network Service Lifecycle Management Rest API.
-
-Version information
--------------------
-
-*Version* : 1.0.0
-
-Contact information
--------------------
-
-| *Contact* : ONAP VFC team
-| *Contact Email* : onap-discuss@lists.onap.org
-
-URI scheme
-----------
-
-| *BasePath* : /api/nslcm/v1
-| *Schemes* : HTTP, HTTPS
-
-Consumes
---------
-
-- ``application/json``
-
-Produces
---------
-
-- ``application/json``
-
-Paths
-=====
-
-jobstatus
----------
-
-::
-
- GET /jobs/{jobId}
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **jobId** | job Id | string |
-| * | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Query | | **respons | job response message id | string |
-| ** | eId** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+-------------------------+--------------------------------------------------+
-| HTTP Code | Schema |
-+=========================+==================================================+
-| **202** | `JobDetailInfo <#_jobdetailinfo>`__ |
-+-------------------------+--------------------------------------------------+
-
-Tags
-~~~~
-
-- job
-
-ns create
----------
-
-::
-
- POST /ns
-
-Description
-~~~~~~~~~~~
-
-ns create
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Body* | | **NSCreat | NS Instance Create Request | `NsCreateRequest |
-| * | eRequest** | | <#_nscreaterequ |
-| | | *required | | est>`__ |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | successful operation | `NsCreateRespo |
-| | | nse <#_nscreat |
-| | | eresponse>`__ |
-+---------+----------------------------------------------------+----------------+
-| **404** | URL not found | No Content |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-ns get
-------
-
-::
-
- GET /ns
-
-Description
-~~~~~~~~~~~
-
-ns get
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Query | | **csarId* | job response message id | string |
-| ** | * | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | successful operation | `NsInstancesIn |
-| | | fo <#_nsinstan |
-| | | cesinfo>`__ |
-+---------+----------------------------------------------------+----------------+
-| **404** | URL not found | No Content |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-ns Instantiate
---------------
-
-::
-
- POST /ns/{nsInstanceId}/Instantiate
-
-Description
-~~~~~~~~~~~
-
-ns Instantiate
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **nsInsta | | string |
-| * | nceId** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Body* | | **NSInsta | NS Instantiate Request Body | `NsInstantiateRe |
-| * | ntiateReque | | quest <#_nsinsta |
-| | st** | | ntiaterequest>`_ |
-| | | *required | | _ |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | | `JobInfo <#_jo |
-| | | binfo>`__ |
-+---------+----------------------------------------------------+----------------+
-| **201** | Invalid Request | No Content |
-+---------+----------------------------------------------------+----------------+
-| **404** | URL not found | No Content |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-ns scale
---------
-
-::
-
- POST /ns/{nsInstanceId}/scale
-
-Description
-~~~~~~~~~~~
-
-ns scale
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **nsInsta | | string |
-| * | nceId** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Body* | | **ScaleNS | Scale NS Request Body | `NsScaleRequest |
-| * | Request** | | <#_nsscalereques |
-| | | *required | | t>`__ |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | | `JobInfo <#_jo |
-| | | binfo>`__ |
-+---------+----------------------------------------------------+----------------+
-| **201** | Invalid Request | No Content |
-+---------+----------------------------------------------------+----------------+
-| **404** | URL not found | No Content |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-ns get
-------
-
-::
-
- GET /ns/{ns_instance_id}
-
-Description
-~~~~~~~~~~~
-
-ns get
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **200** | successful operation | `NsInstanceInf |
-| | | o <#_nsinstanc |
-| | | einfo>`__ |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-ns delete
----------
-
-::
-
- DELETE /ns/{ns_instance_id}
-
-Description
-~~~~~~~~~~~
-
-ns delete
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **ns\_ins | Identifier of the NS instance. | string |
-| * | tance\_id** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **204** | The NS instance resource and the associated NS | No Content |
-| | identifier were deleted successfully. | |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-ns heal
--------
-
-::
-
- POST /ns/{ns_instance_id}/heal
-
-Description
-~~~~~~~~~~~
-
-ns heal
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **ns\_ins | Identifier of the NS instance. | string |
-| * | tance\_id** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Body* | | **healVnf | healVnfData | `NsHealRequest < |
-| * | Data** | | #_nshealrequest> |
-| | | *required | | `__ |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **202** | | `JobInfo <#_jo |
-| | | binfo>`__ |
-+---------+----------------------------------------------------+----------------+
-| **404** | URL not found | No Content |
-+---------+----------------------------------------------------+----------------+
-| **500** | the url is invalid | No Content |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-ns terminate
-------------
-
-::
-
- POST /ns/{ns_instance_id}/terminate
-
-Description
-~~~~~~~~~~~
-
-ns terminate
-
-Parameters
-~~~~~~~~~~
-
-+---------+-------------+--------------------------------------+------------------+
-| Type | Name | Description | Schema |
-+=========+=============+======================================+==================+
-| **Path* | | **ns\_ins | Identifier of the NS instance. | string |
-| * | tance\_id** | | |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-| **Body* | | **NsTermi | NsTerminateRequest | `NsTerminateRequ |
-| * | nateRequest | | est <#_nstermina |
-| | ** | | terequest>`__ |
-| | | *required | | |
-| | * | | |
-+---------+-------------+--------------------------------------+------------------+
-
-Responses
-~~~~~~~~~
-
-+---------+----------------------------------------------------+----------------+
-| HTTP | Description | Schema |
-| Code | | |
-+=========+====================================================+================+
-| **202** | | `JobInfo <#_jo |
-| | | binfo>`__ |
-+---------+----------------------------------------------------+----------------+
-| **500** | the url is invalid | No Content |
-+---------+----------------------------------------------------+----------------+
-
-Tags
-~~~~
-
-- ns
-
-Definitions
-===========
-
-JobDetailInfo
--------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **jobId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **responseDescriptor** | `responseDescriptor <#_jobdetailinfo_resp |
-| | *optional* | onsedescriptor>`__ |
-+--------------------------------+-------------------------------------------+
-
-**responseDescriptor**
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **errorCode** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **progress** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **responseHistoryList** | < `jobResponseInfo <#_jobresponseinfo>`__ |
-| | *optional* | > array |
-+--------------------------------+-------------------------------------------+
-| | **responseId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **status** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **statusDescription** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-JobInfo
--------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **jobId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-LocationConstraint
-------------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **locationConstraints** | `locationConstraints <#_locationconstrain |
-| | *optional* | t_locationconstraints>`__ |
-+--------------------------------+-------------------------------------------+
-| | **vnfProfileId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-**locationConstraints**
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **vimid** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-NsCreateRequest
----------------
-
-+-------------+---------------------------------------------+------------------+
-| Name | Description | Schema |
-+=============+=============================================+==================+
-| | **csarId* | the NS package ID | string |
-| * | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **descrip | | string |
-| tion** | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-| | **nsName* | | string |
-| * | | |
-| | *optional | | |
-| * | | |
-+-------------+---------------------------------------------+------------------+
-
-NsCreateResponse
-----------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **nsInstanceId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-NsHealRequest
--------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **additionalParams** | `additionalParams <#_nshealrequest_additi |
-| | *optional* | onalparams>`__ |
-+--------------------------------+-------------------------------------------+
-| | **cause** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vnfInstanceId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-**additionalParams**
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **action** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **actionvminfo** | `actionvminfo <#_nshealrequest_actionvmin |
-| | *optional* | fo>`__ |
-+--------------------------------+-------------------------------------------+
-
-**actionvminfo**
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **vmid** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vmname** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-NsInstanceInfo
---------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **description** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **nsInstanceId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **nsName** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **nsState** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **nsdId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vlInfo** | < `vlInfo <#_vlinfo>`__ > array |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vnfInfo** | < `vnfInfo <#_vnfinfo>`__ > array |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vnffgInfo** | < `vnffgInfo <#_vnffginfo>`__ > array |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-NsInstancesInfo
----------------
-
-*Type* : < `NsInstanceInfo <#_nsinstanceinfo>`__ > array
-
-NsInstantiateRequest
---------------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **LocationConstraints** | < |
-| | *optional* | `LocationConstraint <#_locationconstraint |
-| | >`__ |
-| | > array |
-+--------------------------------+-------------------------------------------+
-| | **additionalParamForNs** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-NsScaleByStepsData
-------------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **aspectId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **numberOfSteps** | integer |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **scalingDirection** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-NsScaleRequest
---------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **scaleNsByStepsData** | `NsScaleByStepsData <#_nsscalebystepsdata |
-| | *optional* | >`__ |
-+--------------------------------+-------------------------------------------+
-| | **scaleType** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-NsTerminateRequest
-------------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **gracefulTerminationTimeout | string |
-| ** | |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **terminationType** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-cpInfo
-------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **cpInstanceId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **cpInstanceName** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **cpdId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-jobResponseInfo
----------------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **errorCode** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **progress** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **responseId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **status** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **statusDescription** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-vlInfo
-------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **relatedCpInstanceId** | < `cpInfo <#_cpinfo>`__ > array |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vlInstanceId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vlInstanceName** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vldId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-vnfInfo
--------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **vnfInstanceId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vnfInstanceName** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vnfdId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-
-vnffgInfo
----------
-
-+--------------------------------+-------------------------------------------+
-| Name | Schema |
-+================================+===========================================+
-| | **cpId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **nfp** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **pnfId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **virtualLinkId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vnfId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
-| | **vnffgInstanceId** | string |
-| | *optional* | |
-+--------------------------------+-------------------------------------------+
diff --git a/docs/sections/apiexample/worddoc2rst.rst b/docs/sections/apiexample/worddoc2rst.rst
deleted file mode 100644
index 2e1f8148..00000000
--- a/docs/sections/apiexample/worddoc2rst.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-
-Word Document Converted to RST
-------------------------------
-This is an example of an APPC API Guide.
-
-.. toctree::
- :maxdepth: 1
-
- ../../../submodules/appc.git/docs/APPC API Guide/APPC API Guide