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