X-Git-Url: https://gerrit.onap.org/r/gitweb?a=blobdiff_plain;f=docs%2Fapi.rst;h=9eab4dac0d141ca41639631539511417b13095fe;hb=198486f728dd14e0c65ff7c995e5a3173596995a;hp=90595fb5fd7824312622a4a69c0ceedce660f9d9;hpb=5e6e1253d98f8738ae6b2d0c2eea0341a514586c;p=dmaap%2Fdbcapi.git diff --git a/docs/api.rst b/docs/api.rst index 90595fb..9eab4da 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,22 @@ 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 +355,22 @@ 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 +379,22 @@ 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 +460,22 @@ 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 +531,22 @@ 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 +612,22 @@ 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** @@ -661,14 +656,14 @@ DMAAP ~~~~~ -Endpoint for this instance of DMaaP object containing values for this OpenDCAE deployment +V2 Endpoint for this instance of DMaaP object containing values for this OpenDCAE deployment -POST ``/dmaap`` ---------------- +POST ``/dmaap_v2`` +------------------ Summary @@ -712,7 +707,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -740,8 +734,8 @@ Type: :ref:`ApiError ` -GET ``/dmaap`` --------------- +POST ``/dmaap`` +--------------- Summary @@ -754,7 +748,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 @@ -785,7 +779,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -813,8 +806,8 @@ Type: :ref:`ApiError ` -PUT ``/dmaap`` --------------- +GET ``/dmaap_v2`` +----------------- Summary @@ -827,7 +820,7 @@ Description .. raw:: html - Update system settings for *dcaeEnvironment*. + returns the `dmaap` object, which contains system wide configuration settings Request @@ -858,7 +851,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -884,32 +876,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 +908,22 @@ 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 +950,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 +977,25 @@ 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 +1022,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 +1052,22 @@ 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 +1092,19 @@ Type: :ref:`ApiError ` + +DR_NODES +~~~~~~~~ -GET ``/dr_nodes`` ------------------ +Endpoint for a Data Router Node server + + + + + +POST ``/dr_nodes`` +------------------ Summary @@ -1158,7 +1117,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 @@ -1186,7 +1145,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1213,21 +1171,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,6 +1208,27 @@ 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", + "version": "somestring" + } + +**204** +^^^^^^^ + Success @@ -1265,7 +1244,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1290,32 +1268,33 @@ Type: :ref:`ApiError ` - -DR_PUBS -~~~~~~~ - - -Endpoint for a Data Router client that implements a Publisher - - - -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 +1310,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`DR_Node ` **Example:** @@ -1339,13 +1318,11 @@ 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 +1348,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 +1375,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 +1386,11 @@ 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 +1416,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 +1440,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 +1456,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`DR_Node ` **Example:** @@ -1522,13 +1464,11 @@ 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 +1492,19 @@ Type: :ref:`ApiError ` + +DR_PUBS +~~~~~~~ -GET ``/dr_pubs`` ----------------- +Endpoint for a Data Router client that implements a Publisher + + + + + +POST ``/dr_pubs`` +----------------- Summary @@ -1568,7 +1517,7 @@ Description .. raw:: html - Returns array of `DR_Pub` objects. Add filter for feedId. + create a DR Publisher in the specified environment. Request @@ -1596,7 +1545,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1624,8 +1572,8 @@ Type: :ref:`ApiError ` -PUT ``/dr_pubs/{pubId}`` ------------------------- +DELETE ``/dr_pubs/{pubId}`` +--------------------------- Summary @@ -1638,7 +1586,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 +1609,28 @@ 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", + "username": "somestring", + "userpwd": "somestring" + } + +**204** +^^^^^^^ + Success @@ -1676,7 +1646,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1702,32 +1671,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 @@ -1755,7 +1725,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1783,31 +1752,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 @@ -1835,7 +1794,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1863,21 +1821,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 +1845,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 @@ -1915,7 +1873,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1941,10 +1898,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 +1923,7 @@ Description .. raw:: html - Returns array of `DR_Sub` objects. Add filter for feedId. + Create a `DR_Sub` object. Request @@ -1973,19 +1939,27 @@ 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 +1987,8 @@ Type: :ref:`ApiError ` -PUT ``/dr_subs/{subId}`` ------------------------- +DELETE ``/dr_subs/{subId}`` +--------------------------- Summary @@ -2027,7 +2001,7 @@ Description .. raw:: html - Update a `DR_Sub` object, selected by subId + Delete a `DR_Sub` object, selected by subId Parameters ++++++++++ @@ -2053,19 +2027,27 @@ 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,36 +2073,37 @@ Type: :ref:`ApiError ` - -FEEDS -~~~~~ - - -Endpoint for a Data Router Feed - - - -POST ``/feeds`` ---------------- +GET ``/dr_subs/{subId}`` +------------------------ Summary +++++++ -return Feed details +return DR_Sub details Description +++++++++++ .. raw:: html - Create a of `Feed` object. - - -Request -+++++++ + 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 @@ -2132,19 +2115,105 @@ 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", + "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" } @@ -2172,6 +2241,250 @@ Type: :ref:`ApiError ` +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", + "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 + + + + + +POST ``/feeds`` +--------------- + + +Summary ++++++++ + +return Feed details + +Description ++++++++++++ + +.. raw:: html + + 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 ++++++++ + + +Responses ++++++++++ + +**200** +^^^^^^^ + +Success + + +Type: :ref:`Feed ` + +**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", + "username": "somestring", + "userpwd": "somestring" + }, + { + "dcaeLocationName": "somestring", + "feedId": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "pubId": "somestring", + "status": "EMPTY", + "username": "somestring", + "userpwd": "somestring" + } + ], + "status": "EMPTY", + "subs": [ + { + "bytes": [ + "somestring", + "somestring" + ], + "dcaeLocationName": "somestring", + "deliveryURL": "somestring", + "feedId": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "logURL": "somestring", + "owner": "somestring", + "status": "EMPTY", + "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", + "subId": "somestring", + "suspended": true, + "use100": true, + "username": "somestring", + "userpwd": "somestring" + } + ], + "subscribeURL": "somestring", + "suspended": true + } + +**400** +^^^^^^^ + +Error + + +Type: :ref:`ApiError ` + +**Example:** + +.. code-block:: javascript + + { + "code": 1, + "fields": "somestring", + "is2xx": true, + "message": "somestring" + } + + + + + DELETE ``/feeds/{id}`` ---------------------- @@ -2240,7 +2553,6 @@ Type: :ref:`Feed ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" }, @@ -2250,13 +2562,11 @@ Type: :ref:`Feed ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } ], "status": "EMPTY", - "statusValid": true, "subs": [ { "bytes": [ @@ -2270,7 +2580,6 @@ Type: :ref:`Feed ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2289,7 +2598,6 @@ Type: :ref:`Feed ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2307,21 +2615,88 @@ 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", + "username": "somestring", + "userpwd": "somestring" + }, + { + "dcaeLocationName": "somestring", + "feedId": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "pubId": "somestring", + "status": "EMPTY", + "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", + "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", + "subId": "somestring", + "suspended": true, + "use100": true, + "username": "somestring", + "userpwd": "somestring" + } + ], + "subscribeURL": "somestring", + "suspended": true } **400** @@ -2399,7 +2774,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -2469,21 +2843,88 @@ 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", + "username": "somestring", + "userpwd": "somestring" + }, + { + "dcaeLocationName": "somestring", + "feedId": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "pubId": "somestring", + "status": "EMPTY", + "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", + "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", + "subId": "somestring", + "suspended": true, + "use100": true, + "username": "somestring", + "userpwd": "somestring" + } + ], + "subscribeURL": "somestring", + "suspended": true } **400** @@ -2549,21 +2990,88 @@ 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", + "username": "somestring", + "userpwd": "somestring" + }, + { + "dcaeLocationName": "somestring", + "feedId": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "pubId": "somestring", + "status": "EMPTY", + "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", + "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", + "subId": "somestring", + "suspended": true, + "use100": true, + "username": "somestring", + "userpwd": "somestring" + } + ], + "subscribeURL": "somestring", + "suspended": true } **400** @@ -2643,7 +3151,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -2687,14 +3194,14 @@ POST ``/mr_clients`` Summary +++++++ -return MR_Client details +Associate an MR_Client object to a Topic Description +++++++++++ .. raw:: html - Create a `MR_Client` object. + Create a `MR_Client` object.The `dcaeLocation` attribute is used to match an `MR_Cluster` object with the same value, with the intent of localizing message traffic. In legacy implementation, the `clientRole` is granted appropriate permission in AAF. Newer implementions may instead specify an AAF Identity, which will be added to the appropriate `Topic` role. Request @@ -2710,21 +3217,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "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** @@ -2757,7 +3268,7 @@ DELETE ``/mr_clients/{subId}`` Summary +++++++ -return MR_Client details +Delete an MR_Client object Description +++++++++++ @@ -2801,13 +3312,13 @@ Type: :ref:`MR_Client ` "somestring", "somestring" ], + "clientIdentity": "somestring", "clientRole": "somestring", "dcaeLocationName": "somestring", "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "mrClientId": "somestring", "status": "EMPTY", - "statusValid": true, "topicURL": "somestring" } @@ -2817,21 +3328,25 @@ Type: :ref:`MR_Client ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "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 +3402,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "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 +3486,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "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** @@ -3014,7 +3537,7 @@ PUT ``/mr_clients/{clientId}`` Summary +++++++ -return MR_Client details +Update an MR_Client object Description +++++++++++ @@ -3047,21 +3570,25 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Client ` **Example:** .. code-block:: javascript { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "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 +3653,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3134,13 +3661,14 @@ 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 +3743,11 @@ 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 +3758,7 @@ Type: :ref:`MR_Cluster ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3240,13 +3766,14 @@ 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 +3839,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3320,13 +3847,14 @@ 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 +3910,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3390,13 +3918,14 @@ 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 +3991,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3470,13 +3999,14 @@ 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** @@ -3518,14 +4048,24 @@ POST ``/topics`` Summary +++++++ -return Topic details +Create a Topic object Description +++++++++++ .. raw:: html - Create `Topic` object. + Create `Topic` object.For convenience, the message body may populate the `clients` array, in which case each entry will be added as an `MR_Client`. Beginning in ONAP Dublin Release, dbcapi will create two AAF Roles by default, one each for the publisher and subscriber per topic. MR_Clients can then specify an AAF Identity to be added to the appropriate default Role, avoiding the need to create Role(s) in advance. + +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 +4081,59 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "clients": [ + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + }, + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + } + ], + "formatUuid": "somestring", + "fqtn": "somestring", + "fqtnStyle": "FQTN_NOT_SPECIFIED", + "globalMrURL": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "owner": "somestring", + "partitionCount": "somestring", + "publisherRole": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", - "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "subscriberRole": "somestring", + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3628,23 +4206,19 @@ Type: :ref:`Topic ` .. code-block:: javascript { - "bytes": [ - "somestring", - "somestring" - ], "clients": [ { "action": [ "somestring", "somestring" ], + "clientIdentity": "somestring", "clientRole": "somestring", "dcaeLocationName": "somestring", "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "mrClientId": "somestring", "status": "EMPTY", - "statusValid": true, "topicURL": "somestring" }, { @@ -3652,13 +4226,13 @@ Type: :ref:`Topic ` "somestring", "somestring" ], + "clientIdentity": "somestring", "clientRole": "somestring", "dcaeLocationName": "somestring", "fqtn": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "mrClientId": "somestring", "status": "EMPTY", - "statusValid": true, "topicURL": "somestring" } ], @@ -3667,11 +4241,13 @@ Type: :ref:`Topic ` "fqtnStyle": "FQTN_NOT_SPECIFIED", "globalMrURL": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "numClients": 1, "owner": "somestring", + "partitionCount": "somestring", + "publisherRole": "somestring", "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", - "statusValid": true, + "subscriberRole": "somestring", "tnxEnabled": "somestring", "topicDescription": "somestring", "topicName": "somestring", @@ -3684,21 +4260,59 @@ Type: :ref:`Topic ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "clients": [ + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + }, + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + } + ], + "formatUuid": "somestring", + "fqtn": "somestring", + "fqtnStyle": "FQTN_NOT_SPECIFIED", + "globalMrURL": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "owner": "somestring", + "partitionCount": "somestring", + "publisherRole": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", - "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "subscriberRole": "somestring", + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3764,21 +4378,59 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "clients": [ + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + }, + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + } + ], + "formatUuid": "somestring", + "fqtn": "somestring", + "fqtnStyle": "FQTN_NOT_SPECIFIED", + "globalMrURL": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "owner": "somestring", + "partitionCount": "somestring", + "publisherRole": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", - "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "subscriberRole": "somestring", + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3834,21 +4486,59 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "clients": [ + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + }, + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + } + ], + "formatUuid": "somestring", + "fqtn": "somestring", + "fqtnStyle": "FQTN_NOT_SPECIFIED", + "globalMrURL": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "owner": "somestring", + "partitionCount": "somestring", + "publisherRole": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", - "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "subscriberRole": "somestring", + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3914,21 +4604,59 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`Topic ` **Example:** .. code-block:: javascript { - "dcaeLocationName": "somestring", - "feedId": "somestring", + "clients": [ + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + }, + { + "action": [ + "somestring", + "somestring" + ], + "clientIdentity": "somestring", + "clientRole": "somestring", + "dcaeLocationName": "somestring", + "fqtn": "somestring", + "lastMod": "2015-01-01T15:00:00.000Z", + "mrClientId": "somestring", + "status": "EMPTY", + "topicURL": "somestring" + } + ], + "formatUuid": "somestring", + "fqtn": "somestring", + "fqtnStyle": "FQTN_NOT_SPECIFIED", + "globalMrURL": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", - "pubId": "somestring", + "owner": "somestring", + "partitionCount": "somestring", + "publisherRole": "somestring", + "replicationCase": "REPLICATION_NOT_SPECIFIED", + "replicationCount": "somestring", "status": "EMPTY", - "statusValid": true, - "username": "somestring", - "userpwd": "somestring" + "subscriberRole": "somestring", + "tnxEnabled": "somestring", + "topicDescription": "somestring", + "topicName": "somestring", + "version": "somestring" } **400** @@ -3983,6 +4711,7 @@ BrTopic Model Structure brSource | No | string | | | brTarget | No | string | | | + mmAgentName | No | string | | | topicCount | No | integer | int32 | | .. _d_d15e2cee407536866c875375e3f705e0: @@ -3998,9 +4727,8 @@ DR_Node Model Structure dcaeLocationName | No | string | | | fqdn | No | string | | | hostName | No | string | | | - lastMod | No | string | date-time | | + lastMod | No | string | date-time | | datestamp for last update to this object status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | - statusValid | No | boolean | | | version | No | string | | | .. _d_e926d3fa8701e0cc9c8ed1761b3255cd: @@ -4015,10 +4743,9 @@ DR_Pub Model Structure dcaeLocationName | No | string | | | feedId | No | string | | | - lastMod | No | string | date-time | | + lastMod | No | string | date-time | | datestamp for last update to this object pubId | No | string | | | status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | - statusValid | No | boolean | | | username | No | string | | | userpwd | No | string | | | @@ -4036,11 +4763,10 @@ DR_Sub Model Structure dcaeLocationName | No | string | | | deliveryURL | No | string | | | feedId | No | string | | | - lastMod | No | string | date-time | | + lastMod | No | string | date-time | | datestamp for last update to this object 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 | | | @@ -4061,11 +4787,10 @@ DcaeLocation Model Structure clli | No | string | | | dcaeLayer | No | string | | | dcaeLocationName | No | string | | | - lastMod | No | string | date-time | | + lastMod | No | string | date-time | | datestamp for last update to this object local | No | boolean | | | openStackAvailabilityZone | No | string | | | status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | - statusValid | No | boolean | | | subnet | No | string | | | .. _d_4ea0e7758a1f8502222793e4a13b04f7: @@ -4082,11 +4807,10 @@ Dmaap Model Structure bridgeAdminTopic | No | string | | | dmaapName | No | string | | | drProvUrl | No | string | | | - lastMod | No | string | date-time | | + lastMod | No | string | date-time | | datestamp for last update to this object 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 | | | @@ -4107,13 +4831,12 @@ Feed Model Structure feedName | No | string | | | feedVersion | No | string | | | formatUuid | No | string | | | - lastMod | No | string | date-time | | + lastMod | No | string | date-time | | datestamp for last update to this object logURL | No | string | | | owner | No | string | | | publishURL | No | string | | | pubs | No | array of :ref:`DR_Pub ` | | | status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | - statusValid | No | boolean | | | subs | No | array of :ref:`DR_Sub ` | | | subscribeURL | No | string | | | suspended | No | boolean | | | @@ -4128,15 +4851,15 @@ MR_Client Model Structure :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 | | | + action | No | array of string | | | one or more actions from the set ('pub', 'sub', 'view') for which this client needs Permission + clientIdentity | No | string | | | an AAF identity to be associated to an appropriate topic Role + clientRole | No | string | | | an AAF Role to be granted an appropriate Permission. If specified, takes precedence over clientIdentity, for backwards compatibility. + dcaeLocationName | No | string | | | a tag indicating a logical deployment site + fqtn | No | string | | | Fully Qualified Topic Name constructed by dbcapi + lastMod | No | string | date-time | | datestamp for last update to this object + mrClientId | No | string | | | a unique identifier generated by dbcapi for this client status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | - statusValid | No | boolean | | | - topicURL | No | string | | | + topicURL | No | string | | | the URL for a MR instance - typically in the same dcaeLocation - that this client should use to access the topic .. _d_eec7176a0080debe1b19c2dad2e97c24: @@ -4150,10 +4873,11 @@ 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 | | | @@ -4167,29 +4891,14 @@ MirrorMaker Model Structure :header: "Name", "Required", "Type", "Format", "Properties", "Description" :widths: 20, 10, 15, 15, 30, 25 - lastMod | No | string | date-time | | + lastMod | No | string | date-time | | datestamp for last update to this object 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: - -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: @@ -4201,20 +4910,21 @@ Topic Model Structure :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 ` | | | - 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']} | + clients | No | array of :ref:`MR_Client ` | | | an array of `MR_Client` objects associated to this `Topic` + formatUuid | No | string | | | a reference to an identifier that describes a data format used for this `Topic` + fqtn | No | string | | | Fully Qualified Topic Name constructed by dbcapi, following the rules for `fqtnStyle` + fqtnStyle | No | string | | {'enum': ['FQTN_NOT_SPECIFIED', 'FQTN_LEGACY_FORMAT', 'FQTN_PROJECTID_FORMAT', 'FQTN_PROJECTID_VERSION_FORMAT']} | the construction rule for the `fqtn` field + globalMrURL | No | string | | | the URL of an outside MR instance + lastMod | No | string | date-time | | datestamp for last update to this object + owner | No | string | | | a label used to identify who requested this `Topic` to be provisioned. In the future this may be an AAF Identity. + partitionCount | No | string | | | the kafka attribute for specifying the number of partitions + publisherRole | No | string | | | a value generated by dbcapi, this AAF Role has permission to publish to this `Topic` + 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']} | An indicator for how this `Topic` should be replicated when there are more than one `MR_Cluster` instances + replicationCount | No | string | | | the kafka attribute for specifying replication within an `MR_Cluster` instance status | No | string | | {'enum': ['EMPTY', 'NEW', 'STAGED', 'VALID', 'INVALID', 'DELETED']} | - statusValid | No | boolean | | | + subscriberRole | No | string | | | a value generated by dbcapi, this AAF Role has permission to subscribe to this `Topic` tnxEnabled | No | string | | | - topicDescription | No | string | | | - topicName | No | string | | | - version | No | string | | | + topicDescription | No | string | | | a description of what this Topic is used for + topicName | No | string | | | the short name used by humans, and utilized to construct the `FQTN` + version | No | string | | | a hook for any versioning needed for managing a `Topic` over time