[{"label":"Latest (6.4.0)","version":"latest"}]
vrealize-network-insight-api

Create Subscriber

Description

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

Request

URL

URL


post
https://vrni.example.com/api/ni/settings/databus/subscribers
Copy

Request Body

Request Body

DatabusSubscriber of type(s) application/json Required

Databus Subscriber Request

{
    "id": "9c488c91-692e-4992-a83f-ee33a0f9a6c6",
    "message_group": "problems",
    "url": "https://data-pipeline.vmware.com/vrni/events"
}
string
id Optional

unique id assigned for the receiver by vRNI. 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.


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.

Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns DatabusSubscriber of type(s) application/json
{
    "id": "9c488c91-692e-4992-a83f-ee33a0f9a6c6",
    "message_group": "problems",
    "url": "https://data-pipeline.vmware.com/vrni/events"
}
string
id Optional

unique id assigned for the receiver by vRNI. 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.


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.

Errors

Errors

ApiError
400

Bad Request


ApiError
401

Unauthorized


ApiError
403

Forbidden


ApiError
500

Internal Error

Code Samples

Code Samples

cURL Command

curl -X POST -H "Content-Type: application/json" -d '{"id":"9c488c91-692e-4992-a83f-ee33a0f9a6c6","message_group":"problems","url":"https://data-pipeline.vmware.com/vrni/events"}' https://vrni.example.com/api/ni/settings/databus/subscribers


[{"label":"Latest (6.4.0)","version":"latest"}]
vrealize-network-insight-api
Settings Operations
Feedback

Was this page helpful?