X-Git-Url: https://gerrit.onap.org/r/gitweb?p=dmaap%2Fdbcapi.git;a=blobdiff_plain;f=docs%2Fapi.rst;h=624727da22a294ee0c7f72bc14f646c836036aa9;hp=401cd63f1f2470d21574e0f0e5a6015262ca1f0e;hb=HEAD;hpb=c5780d2978120fc6b4ba70a399664de8405f7c20 diff --git a/docs/api.rst b/docs/api.rst index 401cd63..624727d 100644 --- a/docs/api.rst +++ b/docs/api.rst @@ -1,5 +1,6 @@ DMaaP Bus Controller REST API 1.1.0 =================================== +.. _offeredapis: .. toctree:: :maxdepth: 3 @@ -121,24 +122,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** @@ -206,24 +200,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** @@ -288,24 +275,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** @@ -371,24 +356,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** @@ -397,24 +380,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** @@ -480,24 +461,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** @@ -553,24 +532,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** @@ -636,24 +613,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** @@ -733,7 +708,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -806,7 +780,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -879,7 +852,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -952,7 +924,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -1025,7 +996,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -1098,7 +1068,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -1177,7 +1146,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1256,7 +1224,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1278,7 +1245,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1357,7 +1323,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1426,7 +1391,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1505,7 +1469,6 @@ Type: :ref:`DR_Node ` "hostName": "somestring", "lastMod": "2015-01-01T15:00:00.000Z", "status": "EMPTY", - "statusValid": true, "version": "somestring" } @@ -1583,7 +1546,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1663,7 +1625,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1686,7 +1647,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1766,7 +1726,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1836,7 +1795,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -1916,7 +1874,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -2001,7 +1958,6 @@ Type: :ref:`DR_Sub ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2090,7 +2046,6 @@ Type: :ref:`DR_Sub ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2179,7 +2134,6 @@ Type: :ref:`DR_Sub ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2258,7 +2212,6 @@ Type: :ref:`DR_Sub ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2347,7 +2300,6 @@ Type: :ref:`DR_Sub ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2427,21 +2379,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** @@ -2535,7 +2554,6 @@ Type: :ref:`Feed ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" }, @@ -2545,13 +2563,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": [ @@ -2565,7 +2581,6 @@ Type: :ref:`Feed ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2584,7 +2599,6 @@ Type: :ref:`Feed ` "logURL": "somestring", "owner": "somestring", "status": "EMPTY", - "statusValid": true, "subId": "somestring", "suspended": true, "use100": true, @@ -2602,21 +2616,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** @@ -2694,7 +2775,6 @@ Type: :ref:`DR_Pub ` "lastMod": "2015-01-01T15:00:00.000Z", "pubId": "somestring", "status": "EMPTY", - "statusValid": true, "username": "somestring", "userpwd": "somestring" } @@ -2764,23 +2844,90 @@ 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", - "status": "EMPTY", - "statusValid": true, - "username": "somestring", - "userpwd": "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", + "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** ^^^^^^^ @@ -2844,21 +2991,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** @@ -2938,7 +3152,6 @@ Type: :ref:`Dmaap ` "loggingUrl": "somestring", "nodeKey": "somestring", "status": "EMPTY", - "statusValid": true, "topicNsRoot": "somestring", "version": "somestring" } @@ -2982,14 +3195,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 @@ -3005,21 +3218,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** @@ -3052,7 +3269,7 @@ DELETE ``/mr_clients/{subId}`` Summary +++++++ -return MR_Client details +Delete an MR_Client object Description +++++++++++ @@ -3096,13 +3313,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" } @@ -3112,21 +3329,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** @@ -3182,21 +3403,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** @@ -3262,21 +3487,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** @@ -3309,7 +3538,7 @@ PUT ``/mr_clients/{clientId}`` Summary +++++++ -return MR_Client details +Update an MR_Client object Description +++++++++++ @@ -3342,21 +3571,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** @@ -3421,7 +3654,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3429,13 +3662,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** @@ -3514,7 +3748,6 @@ Type: :ref:`MR_Cluster ` "replicationGroup": "somestring", "sourceReplicationPort": "somestring", "status": "EMPTY", - "statusValid": true, "targetReplicationPort": "somestring", "topicPort": "somestring", "topicProtocol": "somestring" @@ -3526,7 +3759,7 @@ Type: :ref:`MR_Cluster ` Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3534,13 +3767,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** @@ -3606,7 +3840,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3614,13 +3848,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** @@ -3676,7 +3911,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3684,13 +3919,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** @@ -3756,7 +3992,7 @@ Responses Success -Type: :ref:`DR_Pub ` +Type: :ref:`MR_Cluster ` **Example:** @@ -3764,13 +4000,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** @@ -3812,14 +4049,14 @@ 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 ++++++++++ @@ -3845,21 +4082,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** @@ -3932,23 +4207,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" }, { @@ -3956,13 +4227,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" } ], @@ -3971,13 +4242,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", @@ -3990,21 +4261,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** @@ -4070,21 +4379,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** @@ -4140,21 +4487,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** @@ -4220,21 +4605,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** @@ -4305,9 +4728,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: @@ -4322,10 +4744,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 | | | @@ -4343,11 +4764,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 | | | @@ -4368,11 +4788,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: @@ -4389,11 +4808,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 | | | @@ -4414,13 +4832,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 | | | @@ -4435,15 +4852,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: @@ -4461,7 +4878,6 @@ MR_Cluster Model Structure 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 | | | @@ -4476,11 +4892,10 @@ 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 | | | @@ -4496,22 +4911,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 | | | - 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 | | | + 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