Update Subscriber

Update Subscriber

Update subscription to receive data related to a 'message group' from 'Databus'. Receiver url of the subscription can be updated. Message group cannot be updated after creation of the subscription. If there is a requirement to change the message group, a new subscription can be created after deleting the subscription.

Request
URI
PUT
https://{api_host}/api/ni/settings/databus/subscribers/{subscriptionId}
COPY
Path Parameters
string
subscriptionId
Required

ID of the subscription as returned in GET / POST subscription API response


Request Body

Databus Subscriber Request

DatabusSubscriber of type(s) application/json
Required
{
    "id": "9c488c91-692e-4992-a83f-ee33a0f9a6c6",
    "message_group": "problems",
    "url": "https://data-pipeline.vmware.com/vrni/events",
    "filter_tags": [
        {
            "filterKey": "appName",
            "filterValue": [
                "app1",
                "app2"
            ]
        }
    ]
}
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.

array of object
filter_tags
Optional

Filter tag is optional and used only for flows filtering. Please reach out to VMware support to enable filtering functionality in Databus.

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.

array of object
filter_tags
Optional

Filter tag is optional and used only for flows filtering. Please reach out to VMware support to enable filtering functionality in Databus.


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 PUT -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}' https://{api_host}/api/ni/settings/databus/subscribers/{subscriptionId}
                
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
GET
Get Subnet Mappings
POST
Create Subnet Mapping
PUT
Update Subnet Mapping
DELETE
Delete Subnet Mapping
GET
Get Certificate
GET
Get Vidm Configuration
PUT
Update Vidm Configuration
POST
Save Vidm Configuration
DELETE
Delete Vidm Configuration
POST
Enable Vidm
POST
Disable Vidm
PUT
Update Vidm User Group Role
POST
Add Vidm User Group
GET
Get User Groups
GET
Get User Group
DELETE
Delete User Group
PUT
Update Vidm User Role
POST
Add Vidm User
GET
Get Users
GET
Get All Users
GET
Get User
DELETE
Delete User
PUT
Update user password
GET
Get Web Proxies
POST
Add Web Proxy
GET
Get Web Proxy
PUT
Update 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
GET
Get SNMP Engine Id
PUT
Update SNMP Engine Id
GET
List the configured SNMP Trap destination profiles
POST
Add new SNMP Trap destination profile
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
GET
Get All Search Based Alert Configs
POST
Add Search Based Alert Config
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
GET
Get All User Defined Events
Deprecated
POST
Create User Defined Event
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
GET
Get Backup Config
PUT
Update Backup Config
POST
Add Backup Config
DELETE
Delete Backup Config
GET
Get Backup Status Report
GET
Get Restore Config
POST
Add Restore Config
DELETE
Delete Restore Config
GET
Get Restore Status Report
GET
Get Licenses
POST
Validate Serial Number
POST
Activate Serial Number
DELETE
Deactivate Serial Number
GET
Get All Subscriber
POST
Create Subscriber
GET
Get Subscriber
PUT
Update Subscriber
DELETE
Delete Subscriber
GET
Get Certificates Details
GET
Get Login Banner
PUT
Update Login Banner
POST
Add Login Banner
DELETE
Delete Login Banner