Create Subscriber

Create Subscriber

Create subscription to receive data related to a 'message group' from 'Databus'. All the data related to the message group will be sent to the registered 'receiver url'.

Request
URI
POST
https://{api_host}/ni/api/ni/settings/databus/subscribers
COPY
Request Body

Databus Subscriber Request

DatabusSubscriber of type(s) application/json
Optional 
{
    "id": "9c488c91-692e-4992-a83f-ee33a0f9a6c6",
    "message_group": "problems",
    "url": "https://data-pipeline.vmware.com/vrni/events"
}
Authentication
This operation uses the following authentication methods.
Responses
200

Success

Returns DatabusSubscriber of type(s) application/json 
"DatabusSubscriber Object"
string
id
Optional

unique id assigned for the receiver by Operations for Networks. This is not required while creating the subscription

string
message_group
Optional

Message-group name for receiving the data from. Message group of a subscription cannot be changed after creation. Supported message groups - application, flows, problems, metrics, vms, hosts, nics, switchports, vms-metrics, hosts-metrics, flows-metrics, nics-metrics, switchports-metrics

string
url
Optional

URL where the data will be posted to. All the messages from the message group will be posted to this url. If multiple receivers are present behind a load balancer, this can be the url of the load balancer. The url of the subscription can be changed after the creation of the subscription.


400

Bad Request

Returns ApiError of type(s) application/json 
"ApiError Object"
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of object
details
Optional

details


401

Unauthorized

Returns ApiError of type(s) application/json 
"ApiError Object"
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of object
details
Optional

details


403

Forbidden

Returns ApiError of type(s) application/json 
"ApiError Object"
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of object
details
Optional

details


500

Internal Error

Returns ApiError of type(s) application/json 
"ApiError Object"
integer As int32 As int32
code
Optional

code

string
message
Optional

message

array of object
details
Optional

details


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/ni/api/ni/settings/databus/subscribers
On This Page
Settings Operations
GET
Get Ip Tag Ids
Deprecated
GET
Get Ip Tag
Deprecated
POST
Add Ip Tag
Deprecated
POST
Remove Ip Tag
Deprecated
GET
Get Tag Ids V2
GET
Get Ip Tag V2
POST
Add Tag V2
POST
Remove Tag V2
POST
Create Subnet Mapping
GET
Get Subnet Mappings
PUT
Update Subnet Mapping
DELETE
Delete Subnet Mapping
PUT
Update user password
POST
Add Web Proxy
GET
Get Web Proxies
PUT
Update Web Proxy
GET
Get Web Proxy
DELETE
Delete Web Proxy
POST
Validate Connections Via Web Proxy
POST
Validate Web Proxy Migration
GET
Get Connected Clients To Web Proxy
GET
Get Infra Nodes Web Proxy
POST
Add new SNMP Trap destination profile
GET
List the configured SNMP Trap destination profiles
POST
Send Test trap To SNMP destination profile
GET
Get details Of An existing SNMP destination profile
PUT
Update An existing SNMP destination profile
DELETE
Delete An existing SNMP Trap destination profile
POST
Migrate event subscriptions To other SNMP Trap destination profiles
POST
Add Search Based Alert Config
GET
Get All Search Based Alert Configs
POST
Enable Search Based Alert Config
POST
Disable Search Based Alert Config
GET
Get Search Based Alert Config
PUT
Update Search Based Alert Config
DELETE
Delete Search Based Alert Config
POST
Create User Defined Event
Deprecated
GET
Get All User Defined Events
Deprecated
POST
Enable User Defined Event
Deprecated
POST
Disable User Defined Event
Deprecated
GET
Get User Defined Event
Deprecated
PUT
Update User Defined Event
Deprecated
DELETE
Delete User Defined Event
Deprecated
POST
Add Backup Config
PUT
Update Backup Config
GET
Get Backup Config
DELETE
Delete Backup Config
GET
Get Backup Status Report
POST
Add Restore Config
GET
Get Restore Config
DELETE
Delete Restore Config
GET
Get Restore Status Report
POST
Create Subscriber
GET
Get All Subscriber
GET
Get Subscriber
PUT
Update Subscriber
DELETE
Delete Subscriber
POST
Add Syslog Target
GET
Get Syslog Target List
PUT
Update Syslog Target
DELETE
Delete Syslog Target
POST
Send Syslog Test Message
GET
Get Syslog Mapping
POST
Update Syslog Mapping
GET
Get Syslog Status
PATCH
Update Syslog Status