initial rst doc for dbcapi 01/31501/1
authorDominic Lunanuova <dgl@research.att.com>
Mon, 12 Feb 2018 19:12:48 +0000 (19:12 +0000)
committerDominic Lunanuova <dgl@research.att.com>
Mon, 12 Feb 2018 19:15:46 +0000 (19:15 +0000)
this was derived from swagger.json using swg2rst

Change-Id: Id2cf48ccc935ba9f9e8ca977b1f38c2f8eaa6b09
Issue-ID: DMAAP-118
Signed-off-by: Dominic Lunanuova <dgl@research.att.com>
docs/api.rst [new file with mode: 0644]
docs/index.rst [new file with mode: 0644]
pom.xml

diff --git a/docs/api.rst b/docs/api.rst
new file mode 100644 (file)
index 0000000..90595fb
--- /dev/null
@@ -0,0 +1,4220 @@
+DMaaP Bus Controller REST API 1.1.0
+===================================
+
+.. toctree::
+    :maxdepth: 3
+
+
+Description
+~~~~~~~~~~~
+
+provides an API for OpenDCAE components which need to provision underlying DMaaP technologies (Data Router and Message Router). Primary clients for this API are anticipated to be the OpenDCAE Controller, OpenDCAE Orchestrator, OpenDCAE Inventory and the ECOMP Portal.
+
+Objects managed by DMaaP are deployed in a dcaeLocation which is a unique identifier for an OpenStack tenant for a dcaeLayer, opendcae-central (aka ecomp) or opendcae-local-ntc (aka edge).
+
+A dcaeEnvironment (e.g. FTL or prod) has a single DMaaP. A DMaaP is managed by a one or more stateless DMaaP Bus Controller(s), though Bus Controller relies on PGaaS for persistence. Each DMaaP has a single instance of Data Router, which has 1 or more DR_Nodes deployed at each dcaeLocation. DR Clients of type DR_Pub generally publish to a DR_Node that is local to its dcaeLocation. Routing for a Feed is determined by the dcaelocation of its DR_Sub clients.
+
+A DMaaP may have many Message Router instances. Each instance is deployed as an MR_Cluster. One MR_Cluster is deployed at each dcaeLocation. MR_Clients generally communicate to the MR_Cluster at the same dcaeLocation. Replication of messages between MR_Clusters is accomplished by MR Bridge, which is provioned by DMaaP Bus Controller based on Topic attributes.
+
+Therefore, the role of DMaaP Bus Controller is to support other DCAE infrastructure components to dynamically provision DMaaP services on behalf of DMaaP clients, and to assist in any management or discovery activity of its clients.
+
+A convention of this API is to return JSON responses per OpenStack style.
+
+
+
+Contact Information
+~~~~~~~~~~~~~~~~~~~
+
+
+
+
+http://www.onap.org
+
+
+
+
+License
+~~~~~~~
+
+
+`Licensed under the Apache License, Version 2.0 <http://www.apache.org/licenses/LICENSE-2.0>`_
+
+
+
+
+Base URL
+~~~~~~~~
+
+http://www.[host]:[port]/webapi
+https://www.[host]:[port]/webapi
+
+BRIDGE
+~~~~~~
+
+
+Endpoint for retreiving MR Bridge metrics
+
+
+
+
+
+GET ``/bridge``
+---------------
+
+
+Summary
++++++++
+
+return BrTopic details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `BrTopic` objects. If source and target query params are specified, only report on that bridge.  If detail param is true, list topics names, else just a count is returned
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        source | query | No | string |  |  | 
+        target | query | No | string |  |  | 
+        detail | query | No | boolean |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/bridge``
+---------------
+
+
+Summary
++++++++
+
+update MirrorMaker details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    replace the topic list for a specific Bridge.  Use JSON Body for value to replace whitelist, but if refreshFlag param is true, simply refresh using existing whitelist
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        source | query | No | string |  |  | 
+        target | query | No | string |  |  | 
+        refresh | query | No | boolean |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+DCAELOCATIONS
+~~~~~~~~~~~~~
+
+
+an OpenStack tenant purposed for OpenDCAE (i.e. where OpenDCAE components might be deployed)
+
+
+
+
+
+POST ``/dcaeLocations``
+-----------------------
+
+
+Summary
++++++++
+
+return dcaeLocation details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Create some `dcaeLocation` which is a unique identifier for an *OpenStack* tenant purposed for a *dcaeLayer*  (ecomp or edge).
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/dcaeLocations/{locationName}``
+----------------------------------------
+
+
+Summary
++++++++
+
+return dcaeLocation details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    delete a dcaeLocation
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        locationName | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+successful operation
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**204**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dcaeLocations/{locationName}``
+-------------------------------------
+
+
+Summary
++++++++
+
+return dcaeLocation details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns a specific `dcaeLocation` object with specified tag
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        locationName | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dcaeLocations``
+----------------------
+
+
+Summary
++++++++
+
+return dcaeLocation details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `dcaeLocation` objects.  All objects managed by DMaaP are deployed in some `dcaeLocation` which is a unique identifier for an *OpenStack* tenant purposed for a *dcaeLayer*  (ecomp or edge).
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/dcaeLocations/{locationName}``
+-------------------------------------
+
+
+Summary
++++++++
+
+return dcaeLocation details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    update the openStackAvailabilityZone of a dcaeLocation
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        locationName | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+DMAAP
+~~~~~
+
+
+Endpoint for this instance of DMaaP object containing values for this OpenDCAE deployment
+
+
+
+
+
+POST ``/dmaap``
+---------------
+
+
+Summary
++++++++
+
+return dmaap details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Create a new DMaaP set system wide configuration settings for the *dcaeEnvironment*.  Deprecated with introduction of persistence in 1610.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dmaap``
+--------------
+
+
+Summary
++++++++
+
+return dmaap details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    returns the `dmaap` object, which contains system wide configuration settings
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/dmaap``
+--------------
+
+
+Summary
++++++++
+
+return dmaap details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Update system settings for *dcaeEnvironment*.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+DR_NODES
+~~~~~~~~
+
+
+Endpoint for a Data Router Node server
+
+
+
+
+
+POST ``/dr_nodes``
+------------------
+
+
+Summary
++++++++
+
+return DR_Node details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    create a `DR_Node` in a *dcaeLocation*.  Note that multiple `DR_Node`s may exist in the same `dcaeLocation`.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Node <d_d15e2cee407536866c875375e3f705e0>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "fqdn": "somestring", 
+        "hostName": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/dr_nodes/{fqdn}``
+---------------------------
+
+
+Summary
++++++++
+
+No Content
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Delete a single `DR_Node` object.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        fqdn | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+successful operation
+
+
+Type: :ref:`DR_Node <d_d15e2cee407536866c875375e3f705e0>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "fqdn": "somestring", 
+        "hostName": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "version": "somestring"
+    }
+
+**204**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Node <d_d15e2cee407536866c875375e3f705e0>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "fqdn": "somestring", 
+        "hostName": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dr_nodes/{fqdn}``
+------------------------
+
+
+Summary
++++++++
+
+return DR_Node details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Retrieve a single `DR_Node` object.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        fqdn | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Node <d_d15e2cee407536866c875375e3f705e0>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "fqdn": "somestring", 
+        "hostName": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dr_nodes``
+-----------------
+
+
+Summary
++++++++
+
+return DR_Node details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of `DR_Node` object array.  Need to add filter by dcaeLocation.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Node <d_d15e2cee407536866c875375e3f705e0>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "fqdn": "somestring", 
+        "hostName": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/dr_nodes/{fqdn}``
+------------------------
+
+
+Summary
++++++++
+
+return DR_Node details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Update a single `DR_Node` object.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        fqdn | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Node <d_d15e2cee407536866c875375e3f705e0>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "fqdn": "somestring", 
+        "hostName": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+DR_PUBS
+~~~~~~~
+
+
+Endpoint for a Data Router client that implements a Publisher
+
+
+
+
+
+POST ``/dr_pubs``
+-----------------
+
+
+Summary
++++++++
+
+return DR_Pub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    create a DR Publisher in the specified environment.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/dr_pubs/{pubId}``
+---------------------------
+
+
+Summary
++++++++
+
+return DR_Pub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    delete a DR Publisher in the specified environment. Delete a `DR_Pub` object by pubId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        pubId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+successful operation
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**204**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dr_pubs/{pubId}``
+------------------------
+
+
+Summary
++++++++
+
+return DR_Pub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    returns a DR Publisher in the specified environment. Gets a `DR_Pub` object by pubId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        pubId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dr_pubs``
+----------------
+
+
+Summary
++++++++
+
+return DR_Pub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `DR_Pub` objects.  Add filter for feedId.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/dr_pubs/{pubId}``
+------------------------
+
+
+Summary
++++++++
+
+return DR_Pub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    update a DR Publisher in the specified environment.  Update a `DR_Pub` object by pubId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        pubId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+DR_SUBS
+~~~~~~~
+
+
+Endpoint for a Data Router client that implements a Subscriber
+
+
+
+
+
+POST ``/dr_subs``
+-----------------
+
+
+Summary
++++++++
+
+return DR_Sub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Create a  `DR_Sub` object.  
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/dr_subs/{subId}``
+---------------------------
+
+
+Summary
++++++++
+
+return DR_Sub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Delete a  `DR_Sub` object, selected by subId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        subId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dr_subs/{subId}``
+------------------------
+
+
+Summary
++++++++
+
+return DR_Sub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Retrieve a  `DR_Sub` object, selected by subId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        subId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/dr_subs``
+----------------
+
+
+Summary
++++++++
+
+return DR_Sub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `DR_Sub` objects.  Add filter for feedId.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/dr_subs/{subId}``
+------------------------
+
+
+Summary
++++++++
+
+return DR_Sub details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Update a  `DR_Sub` object, selected by subId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        subId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+FEEDS
+~~~~~
+
+
+Endpoint for a Data Router Feed
+
+
+
+
+
+POST ``/feeds``
+---------------
+
+
+Summary
++++++++
+
+return Feed details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Create a of  `Feed` object.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/feeds/{id}``
+----------------------
+
+
+Summary
++++++++
+
+return Feed details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Delete a  `Feed` object, specified by id.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        id | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+successful operation
+
+
+Type: :ref:`Feed <d_289ad39619725df26c9ff382d4c97c75>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "asprClassification": "somestring", 
+        "bytes": [
+            "somestring", 
+            "somestring"
+        ], 
+        "feedDescription": "somestring", 
+        "feedId": "somestring", 
+        "feedName": "somestring", 
+        "feedVersion": "somestring", 
+        "formatUuid": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "logURL": "somestring", 
+        "owner": "somestring", 
+        "publishURL": "somestring", 
+        "pubs": [
+            {
+                "dcaeLocationName": "somestring", 
+                "feedId": "somestring", 
+                "lastMod": "2015-01-01T15:00:00.000Z", 
+                "pubId": "somestring", 
+                "status": "EMPTY", 
+                "statusValid": true, 
+                "username": "somestring", 
+                "userpwd": "somestring"
+            }, 
+            {
+                "dcaeLocationName": "somestring", 
+                "feedId": "somestring", 
+                "lastMod": "2015-01-01T15:00:00.000Z", 
+                "pubId": "somestring", 
+                "status": "EMPTY", 
+                "statusValid": true, 
+                "username": "somestring", 
+                "userpwd": "somestring"
+            }
+        ], 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "subs": [
+            {
+                "bytes": [
+                    "somestring", 
+                    "somestring"
+                ], 
+                "dcaeLocationName": "somestring", 
+                "deliveryURL": "somestring", 
+                "feedId": "somestring", 
+                "lastMod": "2015-01-01T15:00:00.000Z", 
+                "logURL": "somestring", 
+                "owner": "somestring", 
+                "status": "EMPTY", 
+                "statusValid": true, 
+                "subId": "somestring", 
+                "suspended": true, 
+                "use100": true, 
+                "username": "somestring", 
+                "userpwd": "somestring"
+            }, 
+            {
+                "bytes": [
+                    "somestring", 
+                    "somestring"
+                ], 
+                "dcaeLocationName": "somestring", 
+                "deliveryURL": "somestring", 
+                "feedId": "somestring", 
+                "lastMod": "2015-01-01T15:00:00.000Z", 
+                "logURL": "somestring", 
+                "owner": "somestring", 
+                "status": "EMPTY", 
+                "statusValid": true, 
+                "subId": "somestring", 
+                "suspended": true, 
+                "use100": true, 
+                "username": "somestring", 
+                "userpwd": "somestring"
+            }
+        ], 
+        "subscribeURL": "somestring", 
+        "suspended": true
+    }
+
+**204**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/feeds/{id}``
+-------------------
+
+
+Summary
++++++++
+
+return Feed details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Retrieve a  `Feed` object, specified by id.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        id | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/feeds``
+--------------
+
+
+Summary
++++++++
+
+return Feed details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `Feed` objects.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        feedName | query | No | string |  |  | 
+        version | query | No | string |  |  | 
+        match | query | No | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/feeds/{id}``
+-------------------
+
+
+Summary
++++++++
+
+return Feed details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Update a  `Feed` object, specified by id.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        id | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+INFO
+~~~~
+
+
+Endpoint for this instance of DBCL.  Returns health info.
+
+
+
+
+
+GET ``/info``
+-------------
+
+
+Summary
++++++++
+
+return info details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    returns the `info` object
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`Dmaap <d_4ea0e7758a1f8502222793e4a13b04f7>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "accessKeyOwner": "somestring", 
+        "bridgeAdminTopic": "somestring", 
+        "dmaapName": "somestring", 
+        "drProvUrl": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "loggingUrl": "somestring", 
+        "nodeKey": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicNsRoot": "somestring", 
+        "version": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+MR_CLIENTS
+~~~~~~~~~~
+
+
+Endpoint for a Message Router Client that implements a Publisher or a Subscriber
+
+
+
+
+
+POST ``/mr_clients``
+--------------------
+
+
+Summary
++++++++
+
+return MR_Client details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Create a  `MR_Client` object.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/mr_clients/{subId}``
+------------------------------
+
+
+Summary
++++++++
+
+return MR_Client details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Delete a  `MR_Client` object, specified by clientId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        subId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+successful operation
+
+
+Type: :ref:`MR_Client <d_56ff81dc98986e27074d9be2731e3f4c>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "action": [
+            "somestring", 
+            "somestring"
+        ], 
+        "clientRole": "somestring", 
+        "dcaeLocationName": "somestring", 
+        "fqtn": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "mrClientId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicURL": "somestring"
+    }
+
+**204**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/mr_clients``
+-------------------
+
+
+Summary
++++++++
+
+return MR_Client details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `MR_Client` objects.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/mr_clients/{subId}``
+---------------------------
+
+
+Summary
++++++++
+
+return MR_Client details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Retrieve a  `MR_Client` object, specified by clientId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        subId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/mr_clients/{clientId}``
+------------------------------
+
+
+Summary
++++++++
+
+return MR_Client details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Update a  `MR_Client` object, specified by clientId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        clientId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+MR_CLUSTERS
+~~~~~~~~~~~
+
+
+Endpoint for a Message Router servers in a Cluster configuration
+
+
+
+
+
+POST ``/mr_clusters``
+---------------------
+
+
+Summary
++++++++
+
+return MR_Cluster details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Create an  `MR_Cluster` object.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/mr_clusters/{clusterId}``
+-----------------------------------
+
+
+Summary
++++++++
+
+return MR_Cluster details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Delete an  `MR_Cluster` object, specified by clusterId.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        clusterId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+successful operation
+
+
+Type: :ref:`MR_Cluster <d_eec7176a0080debe1b19c2dad2e97c24>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "fqdn": "somestring", 
+        "hosts": [
+            "somestring", 
+            "somestring"
+        ], 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "topicPort": "somestring", 
+        "topicProtocol": "somestring"
+    }
+
+**204**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/mr_clusters/{clusterId}``
+--------------------------------
+
+
+Summary
++++++++
+
+return MR_Cluster details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Retrieve an  `MR_Cluster` object, specified by clusterId.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        clusterId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/mr_clusters``
+--------------------
+
+
+Summary
++++++++
+
+return MR_Cluster details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `MR_Cluster` objects.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/mr_clusters/{clusterId}``
+--------------------------------
+
+
+Summary
++++++++
+
+return MR_Cluster details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Update an  `MR_Cluster` object, specified by clusterId.
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        clusterId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+TOPICS
+~~~~~~
+
+
+Endpoint for retreiving MR Topics
+
+
+
+
+
+POST ``/topics``
+----------------
+
+
+Summary
++++++++
+
+return Topic details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Create  `Topic` object.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+DELETE ``/topics/{topicId}``
+----------------------------
+
+
+Summary
++++++++
+
+return Topic details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Delete a  `Topic` object, identified by topicId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        topicId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+successful operation
+
+
+Type: :ref:`Topic <d_2e99841971da81b9d240071b86bf168d>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "bytes": [
+            "somestring", 
+            "somestring"
+        ], 
+        "clients": [
+            {
+                "action": [
+                    "somestring", 
+                    "somestring"
+                ], 
+                "clientRole": "somestring", 
+                "dcaeLocationName": "somestring", 
+                "fqtn": "somestring", 
+                "lastMod": "2015-01-01T15:00:00.000Z", 
+                "mrClientId": "somestring", 
+                "status": "EMPTY", 
+                "statusValid": true, 
+                "topicURL": "somestring"
+            }, 
+            {
+                "action": [
+                    "somestring", 
+                    "somestring"
+                ], 
+                "clientRole": "somestring", 
+                "dcaeLocationName": "somestring", 
+                "fqtn": "somestring", 
+                "lastMod": "2015-01-01T15:00:00.000Z", 
+                "mrClientId": "somestring", 
+                "status": "EMPTY", 
+                "statusValid": true, 
+                "topicURL": "somestring"
+            }
+        ], 
+        "formatUuid": "somestring", 
+        "fqtn": "somestring", 
+        "fqtnStyle": "FQTN_NOT_SPECIFIED", 
+        "globalMrURL": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "numClients": 1, 
+        "owner": "somestring", 
+        "replicationCase": "REPLICATION_NOT_SPECIFIED", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "tnxEnabled": "somestring", 
+        "topicDescription": "somestring", 
+        "topicName": "somestring", 
+        "version": "somestring"
+    }
+
+**204**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/topics/{topicId}``
+-------------------------
+
+
+Summary
++++++++
+
+return Topic details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Retrieve a  `Topic` object, identified by topicId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        topicId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+GET ``/topics``
+---------------
+
+
+Summary
++++++++
+
+return Topic details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Returns array of  `Topic` objects.
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+
+
+PUT ``/topics/{topicId}``
+-------------------------
+
+
+Summary
++++++++
+
+return Topic details
+
+Description
++++++++++++
+
+.. raw:: html
+
+    Update a  `Topic` object, identified by topicId
+
+Parameters
+++++++++++
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 15, 10, 10, 10, 20, 30
+
+        topicId | path | Yes | string |  |  | 
+
+
+Request
++++++++
+
+
+Responses
++++++++++
+
+**200**
+^^^^^^^
+
+Success
+
+
+Type: :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "dcaeLocationName": "somestring", 
+        "feedId": "somestring", 
+        "lastMod": "2015-01-01T15:00:00.000Z", 
+        "pubId": "somestring", 
+        "status": "EMPTY", 
+        "statusValid": true, 
+        "username": "somestring", 
+        "userpwd": "somestring"
+    }
+
+**400**
+^^^^^^^
+
+Error
+
+
+Type: :ref:`ApiError <d_a3a7580ce9d87225d7f62e6b67b4d036>`
+
+**Example:**
+
+.. code-block:: javascript
+
+    {
+        "code": 1, 
+        "fields": "somestring", 
+        "is2xx": true, 
+        "message": "somestring"
+    }
+
+
+
+  
+Data Structures
+~~~~~~~~~~~~~~~
+
+.. _d_a3a7580ce9d87225d7f62e6b67b4d036:
+
+ApiError Model Structure
+------------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        code | No | integer | int32 |  | 
+        fields | No | string |  |  | 
+        is2xx | No | boolean |  |  | 
+        message | No | string |  |  | 
+
+.. _d_d71baea9d8e4e59bc395ef51f45dff1b:
+
+BrTopic Model Structure
+-----------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        brSource | No | string |  |  | 
+        brTarget | No | string |  |  | 
+        topicCount | No | integer | int32 |  | 
+
+.. _d_d15e2cee407536866c875375e3f705e0:
+
+DR_Node Model Structure
+-----------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        dcaeLocationName | No | string |  |  | 
+        fqdn | No | string |  |  | 
+        hostName | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        version | No | string |  |  | 
+
+.. _d_e926d3fa8701e0cc9c8ed1761b3255cd:
+
+DR_Pub Model Structure
+----------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        dcaeLocationName | No | string |  |  | 
+        feedId | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        pubId | No | string |  |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        username | No | string |  |  | 
+        userpwd | No | string |  |  | 
+
+.. _d_48cf328d246f41e1d11a09251b042f02:
+
+DR_Sub Model Structure
+----------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        bytes | No | array of string |  |  | 
+        dcaeLocationName | No | string |  |  | 
+        deliveryURL | No | string |  |  | 
+        feedId | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        logURL | No | string |  |  | 
+        owner | No | string |  |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        subId | No | string |  |  | 
+        suspended | No | boolean |  |  | 
+        use100 | No | boolean |  |  | 
+        username | No | string |  |  | 
+        userpwd | No | string |  |  | 
+
+.. _d_47d80e451933beb623fcf5257867cbcb:
+
+DcaeLocation Model Structure
+----------------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        central | No | boolean |  |  | 
+        clli | No | string |  |  | 
+        dcaeLayer | No | string |  |  | 
+        dcaeLocationName | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        local | No | boolean |  |  | 
+        openStackAvailabilityZone | No | string |  |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        subnet | No | string |  |  | 
+
+.. _d_4ea0e7758a1f8502222793e4a13b04f7:
+
+Dmaap Model Structure
+---------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        accessKeyOwner | No | string |  |  | 
+        bridgeAdminTopic | No | string |  |  | 
+        dmaapName | No | string |  |  | 
+        drProvUrl | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        loggingUrl | No | string |  |  | 
+        nodeKey | No | string |  |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        topicNsRoot | No | string |  |  | 
+        version | No | string |  |  | 
+
+.. _d_289ad39619725df26c9ff382d4c97c75:
+
+Feed Model Structure
+--------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        asprClassification | No | string |  |  | 
+        bytes | No | array of string |  |  | 
+        feedDescription | No | string |  |  | 
+        feedId | No | string |  |  | 
+        feedName | No | string |  |  | 
+        feedVersion | No | string |  |  | 
+        formatUuid | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        logURL | No | string |  |  | 
+        owner | No | string |  |  | 
+        publishURL | No | string |  |  | 
+        pubs | No | array of :ref:`DR_Pub <d_e926d3fa8701e0cc9c8ed1761b3255cd>` |  |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        subs | No | array of :ref:`DR_Sub <d_48cf328d246f41e1d11a09251b042f02>` |  |  | 
+        subscribeURL | No | string |  |  | 
+        suspended | No | boolean |  |  | 
+
+.. _d_56ff81dc98986e27074d9be2731e3f4c:
+
+MR_Client Model Structure
+-------------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        action | No | array of string |  |  | 
+        clientRole | No | string |  |  | 
+        dcaeLocationName | No | string |  |  | 
+        fqtn | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        mrClientId | No | string |  |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        topicURL | No | string |  |  | 
+
+.. _d_eec7176a0080debe1b19c2dad2e97c24:
+
+MR_Cluster Model Structure
+--------------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        dcaeLocationName | No | string |  |  | 
+        fqdn | No | string |  |  | 
+        hosts | No | array of string |  |  | 
+        lastMod | No | string | date-time |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        topicPort | No | string |  |  | 
+        topicProtocol | No | string |  |  | 
+
+.. _d_08fb211d40d6deb9b6e04b000fd988e4:
+
+MirrorMaker Model Structure
+---------------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        lastMod | No | string | date-time |  | 
+        mmName | No | string |  |  | 
+        sourceCluster | No | string |  |  | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        targetCluster | No | string |  |  | 
+        topicCount | No | integer | int32 |  | 
+        topics | No | array of string |  |  | 
+        vectors | No | array of :ref:`ReplicationVector <d_56f2d64ab7d8ae64594cda45cf85f918>` |  |  | 
+
+.. _d_56f2d64ab7d8ae64594cda45cf85f918:
+
+ReplicationVector Model Structure
+---------------------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        fqtn | No | string |  |  | 
+        sourceCluster | No | string |  |  | 
+        targetCluster | No | string |  |  | 
+
+.. _d_2e99841971da81b9d240071b86bf168d:
+
+Topic Model Structure
+---------------------
+
+.. csv-table::
+    :delim: |
+    :header: "Name", "Required", "Type", "Format", "Properties", "Description"
+    :widths: 20, 10, 15, 15, 30, 25
+
+        bytes | No | array of string |  |  | 
+        clients | No | array of :ref:`MR_Client <d_56ff81dc98986e27074d9be2731e3f4c>` |  |  | 
+        formatUuid | No | string |  |  | 
+        fqtn | No | string |  |  | 
+        fqtnStyle | No | string |  | {'enum': ['FQTN_NOT_SPECIFIED', 'FQTN_LEGACY_FORMAT', 'FQTN_PROJECTID_FORMAT', 'FQTN_PROJECTID_VERSION_FORMAT']} | 
+        globalMrURL | No | string |  |  | 
+        lastMod | No | string | date-time |  | 
+        numClients | No | integer | int32 |  | 
+        owner | No | string |  |  | 
+        replicationCase | No | string |  | {'enum': ['REPLICATION_NOT_SPECIFIED', 'REPLICATION_NONE', 'REPLICATION_EDGE_TO_CENTRAL', 'REPLICATION_EDGE_TO_CENTRAL_TO_GLOBAL', 'REPLICATION_CENTRAL_TO_EDGE', 'REPLICATION_CENTRAL_TO_GLOBAL', 'REPLICATION_GLOBAL_TO_CENTRAL', 'REPLICATION_GLOBAL_TO_CENTRAL_TO_EDGE']} | 
+        status | No | string |  | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | 
+        statusValid | No | boolean |  |  | 
+        tnxEnabled | No | string |  |  | 
+        topicDescription | No | string |  |  | 
+        topicName | No | string |  |  | 
+        version | No | string |  |  | 
+
diff --git a/docs/index.rst b/docs/index.rst
new file mode 100644 (file)
index 0000000..3719ffd
--- /dev/null
@@ -0,0 +1,8 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+
+TODO Add files to toctree and delete this header
+------------------------------------------------
+.. toctree::
+   :maxdepth: 1
+
+   api
diff --git a/pom.xml b/pom.xml
index 2f46cae..c79d947 100644 (file)
--- a/pom.xml
+++ b/pom.xml
@@ -74,7 +74,7 @@ A convention of this API is to return JSON responses per OpenStack style.
     </configuration>
     <executions>
         <execution>
     </configuration>
     <executions>
         <execution>
-            <phase>precompile</phase>
+            <phase>compile</phase>
             <goals>
                 <goal>generate</goal>
             </goals>
             <goals>
                 <goal>generate</goal>
             </goals>