X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fapi.rst;h=5ba2eefbb29b1446167558b6cfc936f495785ca4;hb=956361f657eda468d5980249db6b155c472f5f85;hp=90595fb5fd7824312622a4a69c0ceedce660f9d9;hpb=5e6e1253d98f8738ae6b2d0c2eea0341a514586c;p=dmaap%2Fdbcapi.git diff --git a/docs/api.rst b/docs/api.rst index 90595fb..5ba2eef 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -8,17 +8,39 @@ DMaaP Bus Controller REST API 1.1.0 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. +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. @@ -72,7 +94,7 @@ 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 + 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 ++++++++++ @@ -82,8 +104,7 @@ Parameters :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 | | | + mmagent | query | No | string | | | detail | query | No | boolean | | | @@ -100,24 +121,17 @@ Responses Success -Type: :ref:`Dmaap ` +Type: :ref:`BrTopic ` **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" + "brSource": "somestring", + "brTarget": "somestring", + "mmAgentName": "somestring", + "topicCount": 1 } **400** @@ -157,7 +171,7 @@ 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 + 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.If split param is true, spread whitelist over smaller mmagents. Parameters ++++++++++ @@ -167,9 +181,9 @@ Parameters :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 | | | + mmagent | query | No | string | | | refresh | query | No | boolean | | | + split | query | No | boolean | | | Request @@ -185,24 +199,17 @@ Responses Success -Type: :ref:`Dmaap ` +Type: :ref:`BrTopic ` **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" + "brSource": "somestring", + "brTarget": "somestring", + "mmAgentName": "somestring", + "topicCount": 1 } **400** @@ -267,24 +274,23 @@ Responses Success -Type: :ref:`Dmaap ` +Type: :ref:`DcaeLocation ` **Example:** .. code-block:: javascript { - "accessKeyOwner": "somestring", - "bridgeAdminTopic": "somestring", - "dmaapName": "somestring", - "drProvUrl": "somestring", + "central": true, + "clli": "somestring", + "dcaeLayer": "somestring", + "dcaeLocationName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "loggingUrl": "somestring", - "nodeKey": "somestring", + "local": true, + "openStackAvailabilityZone": "somestring", "status": "EMPTY", "statusValid": true, - "topicNsRoot": "somestring", - "version": "somestring" + "subnet": "somestring" } **400** @@ -350,24 +356,23 @@ Responses successful operation -Type: :ref:`Dmaap ` +Type: :ref:`DcaeLocation ` **Example:** .. code-block:: javascript { - "accessKeyOwner": "somestring", - "bridgeAdminTopic": "somestring", - "dmaapName": "somestring", - "drProvUrl": "somestring", + "central": true, + "clli": "somestring", + "dcaeLayer": "somestring", + "dcaeLocationName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "loggingUrl": "somestring", - "nodeKey": "somestring", + "local": true, + "openStackAvailabilityZone": "somestring", "status": "EMPTY", "statusValid": true, - "topicNsRoot": "somestring", - "version": "somestring" + "subnet": "somestring" } **204** @@ -376,24 +381,23 @@ Type: :ref:`Dmaap ` Success -Type: :ref:`Dmaap ` +Type: :ref:`DcaeLocation ` **Example:** .. code-block:: javascript { - "accessKeyOwner": "somestring", - "bridgeAdminTopic": "somestring", - "dmaapName": "somestring", - "drProvUrl": "somestring", + "central": true, + "clli": "somestring", + "dcaeLayer": "somestring", + "dcaeLocationName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "loggingUrl": "somestring", - "nodeKey": "somestring", + "local": true, + "openStackAvailabilityZone": "somestring", "status": "EMPTY", "statusValid": true, - "topicNsRoot": "somestring", - "version": "somestring" + "subnet": "somestring" } **400** @@ -459,24 +463,23 @@ Responses Success -Type: :ref:`Dmaap ` +Type: :ref:`DcaeLocation ` **Example:** .. code-block:: javascript { - "accessKeyOwner": "somestring", - "bridgeAdminTopic": "somestring", - "dmaapName": "somestring", - "drProvUrl": "somestring", + "central": true, + "clli": "somestring", + "dcaeLayer": "somestring", + "dcaeLocationName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "loggingUrl": "somestring", - "nodeKey": "somestring", + "local": true, + "openStackAvailabilityZone": "somestring", "status": "EMPTY", "statusValid": true, - "topicNsRoot": "somestring", - "version": "somestring" + "subnet": "somestring" } **400** @@ -532,24 +535,23 @@ Responses Success -Type: :ref:`Dmaap ` +Type: :ref:`DcaeLocation ` **Example:** .. code-block:: javascript { - "accessKeyOwner": "somestring", - "bridgeAdminTopic": "somestring", - "dmaapName": "somestring", - "drProvUrl": "somestring", + "central": true, + "clli": "somestring", + "dcaeLayer": "somestring", + "dcaeLocationName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "loggingUrl": "somestring", - "nodeKey": "somestring", + "local": true, + "openStackAvailabilityZone": "somestring", "status": "EMPTY", "statusValid": true, - "topicNsRoot": "somestring", - "version": "somestring" + "subnet": "somestring" } **400** @@ -615,24 +617,23 @@ Responses Success -Type: :ref:`Dmaap ` +Type: :ref:`DcaeLocation ` **Example:** .. code-block:: javascript { - "accessKeyOwner": "somestring", - "bridgeAdminTopic": "somestring", - "dmaapName": "somestring", - "drProvUrl": "somestring", + "central": true, + "clli": "somestring", + "dcaeLayer": "somestring", + "dcaeLocationName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "loggingUrl": "somestring", - "nodeKey": "somestring", + "local": true, + "openStackAvailabilityZone": "somestring", "status": "EMPTY", "statusValid": true, - "topicNsRoot": "somestring", - "version": "somestring" + "subnet": "somestring" } **400** @@ -667,8 +668,8 @@ Endpoint for this instance of DMaaP object containing values for this OpenDCAE d -POST ``/dmaap`` ---------------- +POST ``/dmaap_v2`` +------------------ Summary @@ -740,8 +741,8 @@ Type: :ref:`ApiError ` -GET ``/dmaap`` --------------- +POST ``/dmaap`` +--------------- Summary @@ -754,7 +755,7 @@ Description .. raw:: html - returns the `dmaap` object, which contains system wide configuration settings + Create a new DMaaP set system wide configuration settings for the *dcaeEnvironment*. Deprecated with introduction of persistence in 1610. Request @@ -813,8 +814,8 @@ Type: :ref:`ApiError ` -PUT ``/dmaap`` --------------- +GET ``/dmaap_v2`` +----------------- Summary @@ -827,7 +828,7 @@ Description .. raw:: html - Update system settings for *dcaeEnvironment*. + returns the `dmaap` object, which contains system wide configuration settings Request @@ -884,32 +885,23 @@ Type: :ref:`ApiError ` - -DR_NODES -~~~~~~~~ - - -Endpoint for a Data Router Node server - - - -POST ``/dr_nodes`` ------------------- +GET ``/dmaap`` +-------------- Summary +++++++ -return DR_Node details +return dmaap details Description +++++++++++ .. raw:: html - create a `DR_Node` in a *dcaeLocation*. Note that multiple `DR_Node`s may exist in the same `dcaeLocation`. + returns the `dmaap` object, which contains system wide configuration settings Request @@ -925,19 +917,23 @@ Responses Success -Type: :ref:`DR_Node ` +Type: :ref:`Dmaap ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "fqdn": "somestring", - "hostName": "somestring", + "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" } @@ -964,31 +960,21 @@ Type: :ref:`ApiError ` -DELETE ``/dr_nodes/{fqdn}`` ---------------------------- +PUT ``/dmaap_v2`` +----------------- Summary +++++++ -No Content +return dmaap details 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 | | | + Update system settings for *dcaeEnvironment*. Request @@ -1001,44 +987,26 @@ Responses **200** ^^^^^^^ -successful operation - - -Type: :ref:`DR_Node ` - -**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 ` +Type: :ref:`Dmaap ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "fqdn": "somestring", - "hostName": "somestring", + "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" } @@ -1065,31 +1033,21 @@ Type: :ref:`ApiError ` -GET ``/dr_nodes/{fqdn}`` ------------------------- +PUT ``/dmaap`` +-------------- Summary +++++++ -return DR_Node details +return dmaap 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 | | | + Update system settings for *dcaeEnvironment*. Request @@ -1105,19 +1063,23 @@ Responses Success -Type: :ref:`DR_Node ` +Type: :ref:`Dmaap ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "fqdn": "somestring", - "hostName": "somestring", + "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" } @@ -1142,10 +1104,19 @@ Type: :ref:`ApiError ` + +DR_NODES +~~~~~~~~ + + +Endpoint for a Data Router Node server + + -GET ``/dr_nodes`` ------------------ + +POST ``/dr_nodes`` +------------------ Summary @@ -1158,7 +1129,7 @@ Description .. raw:: html - Returns array of `DR_Node` object array. Need to add filter by dcaeLocation. + create a `DR_Node` in a *dcaeLocation*. Note that multiple `DR_Node`s may exist in the same `dcaeLocation`. Request @@ -1213,21 +1184,21 @@ Type: :ref:`ApiError ` -PUT ``/dr_nodes/{fqdn}`` ------------------------- +DELETE ``/dr_nodes/{fqdn}`` +--------------------------- Summary +++++++ -return DR_Node details +No Content Description +++++++++++ .. raw:: html - Update a single `DR_Node` object. + Delete a single `DR_Node` object. Parameters ++++++++++ @@ -1250,7 +1221,7 @@ Responses **200** ^^^^^^^ -Success +successful operation Type: :ref:`DR_Node ` @@ -1269,53 +1240,76 @@ Type: :ref:`DR_Node ` "version": "somestring" } -**400** +**204** ^^^^^^^ -Error +Success -Type: :ref:`ApiError ` +Type: :ref:`DR_Node ` **Example:** .. code-block:: javascript { - "code": 1, - "fields": "somestring", - "is2xx": true, - "message": "somestring" + "dcaeLocationName": "somestring", + "fqdn": "somestring", + "hostName": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "status": "EMPTY", + "statusValid": true, + "version": "somestring" } +**400** +^^^^^^^ - - -DR_PUBS -~~~~~~~ +Error -Endpoint for a Data Router client that implements a Publisher +Type: :ref:`ApiError ` + +**Example:** + +.. code-block:: javascript + + { + "code": 1, + "fields": "somestring", + "is2xx": true, + "message": "somestring" + } -POST ``/dr_pubs`` ------------------ +GET ``/dr_nodes/{fqdn}`` +------------------------ Summary +++++++ -return DR_Pub details +return DR_Node details Description +++++++++++ .. raw:: html - create a DR Publisher in the specified environment. + 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 @@ -1331,7 +1325,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`DR_Node ` **Example:** @@ -1339,13 +1333,12 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", + "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "version": "somestring" } **400** @@ -1371,31 +1364,21 @@ Type: :ref:`ApiError ` -DELETE ``/dr_pubs/{pubId}`` ---------------------------- +GET ``/dr_nodes`` +----------------- Summary +++++++ -return DR_Pub details +return DR_Node 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 | | | + Returns array of `DR_Node` object array. Need to add filter by dcaeLocation. Request @@ -1408,33 +1391,10 @@ Responses **200** ^^^^^^^ -successful operation - - -Type: :ref:`DR_Pub ` - -**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 ` +Type: :ref:`DR_Node ` **Example:** @@ -1442,13 +1402,12 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", + "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "version": "somestring" } **400** @@ -1474,21 +1433,21 @@ Type: :ref:`ApiError ` -GET ``/dr_pubs/{pubId}`` +PUT ``/dr_nodes/{fqdn}`` ------------------------ Summary +++++++ -return DR_Pub details +return DR_Node details Description +++++++++++ .. raw:: html - returns a DR Publisher in the specified environment. Gets a `DR_Pub` object by pubId + Update a single `DR_Node` object. Parameters ++++++++++ @@ -1498,7 +1457,7 @@ Parameters :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" :widths: 20, 15, 10, 10, 10, 20, 30 - pubId | path | Yes | string | | | + fqdn | path | Yes | string | | | Request @@ -1514,7 +1473,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`DR_Node ` **Example:** @@ -1522,13 +1481,12 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", + "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "version": "somestring" } **400** @@ -1552,10 +1510,19 @@ Type: :ref:`ApiError ` + +DR_PUBS +~~~~~~~ + +Endpoint for a Data Router client that implements a Publisher -GET ``/dr_pubs`` ----------------- + + + + +POST ``/dr_pubs`` +----------------- Summary @@ -1568,7 +1535,7 @@ Description .. raw:: html - Returns array of `DR_Pub` objects. Add filter for feedId. + create a DR Publisher in the specified environment. Request @@ -1624,8 +1591,8 @@ Type: :ref:`ApiError ` -PUT ``/dr_pubs/{pubId}`` ------------------------- +DELETE ``/dr_pubs/{pubId}`` +--------------------------- Summary @@ -1638,7 +1605,7 @@ Description .. raw:: html - update a DR Publisher in the specified environment. Update a `DR_Pub` object by pubId + delete a DR Publisher in the specified environment. Delete a `DR_Pub` object by pubId Parameters ++++++++++ @@ -1661,6 +1628,29 @@ Responses **200** ^^^^^^^ +successful operation + + +Type: :ref:`DR_Pub ` + +**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 @@ -1702,32 +1692,33 @@ Type: :ref:`ApiError ` - -DR_SUBS -~~~~~~~ - - -Endpoint for a Data Router client that implements a Subscriber - - - -POST ``/dr_subs`` ------------------ +GET ``/dr_pubs/{pubId}`` +------------------------ Summary +++++++ -return DR_Sub details +return DR_Pub details Description +++++++++++ .. raw:: html - Create a `DR_Sub` object. + 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 @@ -1783,31 +1774,21 @@ Type: :ref:`ApiError ` -DELETE ``/dr_subs/{subId}`` ---------------------------- +GET ``/dr_pubs`` +---------------- Summary +++++++ -return DR_Sub details +return DR_Pub 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 | | | + Returns array of `DR_Pub` objects. Add filter for feedId. Request @@ -1863,21 +1844,21 @@ Type: :ref:`ApiError ` -GET ``/dr_subs/{subId}`` +PUT ``/dr_pubs/{pubId}`` ------------------------ Summary +++++++ -return DR_Sub details +return DR_Pub details Description +++++++++++ .. raw:: html - Retrieve a `DR_Sub` object, selected by subId + update a DR Publisher in the specified environment. Update a `DR_Pub` object by pubId Parameters ++++++++++ @@ -1887,7 +1868,7 @@ Parameters :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" :widths: 20, 15, 10, 10, 10, 20, 30 - subId | path | Yes | string | | | + pubId | path | Yes | string | | | Request @@ -1941,10 +1922,19 @@ Type: :ref:`ApiError ` + +DR_SUBS +~~~~~~~ -GET ``/dr_subs`` ----------------- +Endpoint for a Data Router client that implements a Subscriber + + + + + +POST ``/dr_subs`` +----------------- Summary @@ -1957,7 +1947,7 @@ Description .. raw:: html - Returns array of `DR_Sub` objects. Add filter for feedId. + Create a `DR_Sub` object. Request @@ -1973,19 +1963,28 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`DR_Sub ` **Example:** .. code-block:: javascript { + "bytes": [ + "somestring", + "somestring" + ], "dcaeLocationName": "somestring", + "deliveryURL": "somestring", "feedId": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "logURL": "somestring", + "owner": "somestring", "status": "EMPTY", "statusValid": true, + "subId": "somestring", + "suspended": true, + "use100": true, "username": "somestring", "userpwd": "somestring" } @@ -2013,8 +2012,8 @@ Type: :ref:`ApiError ` -PUT ``/dr_subs/{subId}`` ------------------------- +DELETE ``/dr_subs/{subId}`` +--------------------------- Summary @@ -2027,7 +2026,7 @@ Description .. raw:: html - Update a `DR_Sub` object, selected by subId + Delete a `DR_Sub` object, selected by subId Parameters ++++++++++ @@ -2053,19 +2052,28 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`DR_Sub ` **Example:** .. code-block:: javascript { + "bytes": [ + "somestring", + "somestring" + ], "dcaeLocationName": "somestring", + "deliveryURL": "somestring", "feedId": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "logURL": "somestring", + "owner": "somestring", "status": "EMPTY", "statusValid": true, + "subId": "somestring", + "suspended": true, + "use100": true, "username": "somestring", "userpwd": "somestring" } @@ -2091,12 +2099,269 @@ Type: :ref:`ApiError ` - -FEEDS -~~~~~ -Endpoint for a Data Router Feed +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_Sub ` + +**Example:** + +.. code-block:: javascript + + { + "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" + } + +**400** +^^^^^^^ + +Error + + +Type: :ref:`ApiError ` + +**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_Sub ` + +**Example:** + +.. code-block:: javascript + + { + "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" + } + +**400** +^^^^^^^ + +Error + + +Type: :ref:`ApiError ` + +**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_Sub ` + +**Example:** + +.. code-block:: javascript + + { + "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" + } + +**400** +^^^^^^^ + +Error + + +Type: :ref:`ApiError ` + +**Example:** + +.. code-block:: javascript + + { + "code": 1, + "fields": "somestring", + "is2xx": true, + "message": "somestring" + } + + + + +FEEDS +~~~~~ + + +Endpoint for a Data Router Feed @@ -2118,6 +2383,16 @@ Description Create a of `Feed` object. +Parameters +++++++++++ + +.. csv-table:: + :delim: | + :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" + :widths: 20, 15, 10, 10, 10, 20, 30 + + useExisting | query | No | string | | | + Request +++++++ @@ -2132,21 +2407,93 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Feed ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", + "asprClassification": "somestring", + "bytes": [ + "somestring", + "somestring" + ], + "feedDescription": "somestring", "feedId": "somestring", + "feedName": "somestring", + "feedVersion": "somestring", + "formatUuid": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "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, - "username": "somestring", - "userpwd": "somestring" + "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 } **400** @@ -2307,21 +2654,93 @@ Type: :ref:`Feed ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`Feed ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", + "asprClassification": "somestring", + "bytes": [ + "somestring", + "somestring" + ], + "feedDescription": "somestring", "feedId": "somestring", + "feedName": "somestring", + "feedVersion": "somestring", + "formatUuid": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "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, - "username": "somestring", - "userpwd": "somestring" + "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 } **400** @@ -2469,21 +2888,93 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Feed ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", + "asprClassification": "somestring", + "bytes": [ + "somestring", + "somestring" + ], + "feedDescription": "somestring", "feedId": "somestring", + "feedName": "somestring", + "feedVersion": "somestring", + "formatUuid": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "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, - "username": "somestring", - "userpwd": "somestring" + "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 } **400** @@ -2549,21 +3040,93 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Feed ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", + "asprClassification": "somestring", + "bytes": [ + "somestring", + "somestring" + ], + "feedDescription": "somestring", "feedId": "somestring", + "feedName": "somestring", + "feedVersion": "somestring", + "formatUuid": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "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, - "username": "somestring", - "userpwd": "somestring" + "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 } **400** @@ -2710,21 +3273,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientRole": "somestring", "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "mrClientId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "topicURL": "somestring" } **400** @@ -2817,21 +3384,25 @@ Type: :ref:`MR_Client ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientRole": "somestring", "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "mrClientId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "topicURL": "somestring" } **400** @@ -2887,21 +3458,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientRole": "somestring", "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "mrClientId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "topicURL": "somestring" } **400** @@ -2967,21 +3542,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientRole": "somestring", "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "mrClientId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "topicURL": "somestring" } **400** @@ -3047,21 +3626,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientRole": "somestring", "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "mrClientId": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "topicURL": "somestring" } **400** @@ -3126,7 +3709,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3134,13 +3717,15 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "replicationGroup": "somestring", + "sourceReplicationPort": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "targetReplicationPort": "somestring", + "topicPort": "somestring", + "topicProtocol": "somestring" } **400** @@ -3215,13 +3800,12 @@ Type: :ref:`MR_Cluster ` { "dcaeLocationName": "somestring", "fqdn": "somestring", - "hosts": [ - "somestring", - "somestring" - ], "lastMod": "2015-01-01T15:00:00.000Z", + "replicationGroup": "somestring", + "sourceReplicationPort": "somestring", "status": "EMPTY", "statusValid": true, + "targetReplicationPort": "somestring", "topicPort": "somestring", "topicProtocol": "somestring" } @@ -3232,7 +3816,7 @@ Type: :ref:`MR_Cluster ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3240,13 +3824,15 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "replicationGroup": "somestring", + "sourceReplicationPort": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "targetReplicationPort": "somestring", + "topicPort": "somestring", + "topicProtocol": "somestring" } **400** @@ -3312,7 +3898,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3320,13 +3906,15 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "replicationGroup": "somestring", + "sourceReplicationPort": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "targetReplicationPort": "somestring", + "topicPort": "somestring", + "topicProtocol": "somestring" } **400** @@ -3382,7 +3970,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3390,13 +3978,15 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "replicationGroup": "somestring", + "sourceReplicationPort": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "targetReplicationPort": "somestring", + "topicPort": "somestring", + "topicProtocol": "somestring" } **400** @@ -3462,7 +4052,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3470,13 +4060,15 @@ Type: :ref:`DR_Pub ` { "dcaeLocationName": "somestring", - "feedId": "somestring", + "fqdn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "replicationGroup": "somestring", + "sourceReplicationPort": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "targetReplicationPort": "somestring", + "topicPort": "somestring", + "topicProtocol": "somestring" } **400** @@ -3527,6 +4119,16 @@ Description Create `Topic` object. +Parameters +++++++++++ + +.. csv-table:: + :delim: | + :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" + :widths: 20, 15, 10, 10, 10, 20, 30 + + useExisting | query | No | string | | | + Request +++++++ @@ -3541,21 +4143,63 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "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", - "pubId": "somestring", + "numClients": 1, + "owner": "somestring", + "partitionCount": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3669,7 +4313,9 @@ Type: :ref:`Topic ` "lastMod": "2015-01-01T15:00:00.000Z", "numClients": 1, "owner": "somestring", + "partitionCount": "somestring", "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", "statusValid": true, "tnxEnabled": "somestring", @@ -3684,21 +4330,63 @@ Type: :ref:`Topic ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "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", - "pubId": "somestring", + "numClients": 1, + "owner": "somestring", + "partitionCount": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3764,21 +4452,63 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "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", - "pubId": "somestring", + "numClients": 1, + "owner": "somestring", + "partitionCount": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3834,21 +4564,63 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "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", - "pubId": "somestring", + "numClients": 1, + "owner": "somestring", + "partitionCount": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3914,21 +4686,63 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "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", - "pubId": "somestring", + "numClients": 1, + "owner": "somestring", + "partitionCount": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3983,6 +4797,7 @@ BrTopic Model Structure brSource | No | string | | | brTarget | No | string | | | + mmAgentName | No | string | | | topicCount | No | integer | int32 | | .. _d_d15e2cee407536866c875375e3f705e0: @@ -4150,10 +4965,12 @@ MR_Cluster Model Structure dcaeLocationName | No | string | | | fqdn | No | string | | | - hosts | No | array of string | | | lastMod | No | string | date-time | | + replicationGroup | No | string | | | + sourceReplicationPort | No | string | | | status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | statusValid | No | boolean | | | + targetReplicationPort | No | string | | | topicPort | No | string | | | topicProtocol | No | string | | | @@ -4175,21 +4992,7 @@ MirrorMaker Model Structure targetCluster | No | string | | | topicCount | No | integer | int32 | | topics | No | array of string | | | - vectors | No | array of :ref:`ReplicationVector ` | | | - -.. _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 | | | + whitelistUpdateJSON | No | string | | | .. _d_2e99841971da81b9d240071b86bf168d: @@ -4210,7 +5013,9 @@ Topic Model Structure 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']} | + partitionCount | 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', 'REPLICATION_EDGE_TO_FQDN', 'REPLICATION_FQDN_TO_EDGE', 'REPLICATION_FQDN_TO_GLOBAL', 'REPLICATION_GLOBAL_TO_FQDN', 'REPLICATION_EDGE_TO_FQDN_TO_GLOBAL', 'REPLICATION_GLOBAL_TO_FQDN_TO_EDGE']} | + replicationCount | No | string | | | status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | statusValid | No | boolean | | | tnxEnabled | No | string | | |