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.

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
{
    "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.

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
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


401

Unauthorized

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


403

Forbidden

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


500

Internal Error

Returns ApiError of type(s) application/json
{
    "code": 0,
    "message": "string",
    "details": [
        {
            "code": 0,
            "message": "string",
            "target": [
                "string"
            ]
        }
    ]
}
integer As int32 As int32
code
Optional

code

string
message
Optional

message

details
Optional

details


Settings Operations
POST
Activate Serial Number
POST
Add new SNMP Trap destination profile
POST
Add Backup Config
POST
Add Ip Tag
Deprecated
POST
Add Login Banner
POST
Add Restore Config
POST
Add Search Based Alert Config
POST
Add Tag V2
POST
Add Vidm User
POST
Add Vidm User Group
POST
Add Web Proxy
POST
Create Subnet Mapping
POST
Create Subscriber
POST
Create User Defined Event
Deprecated
DELETE
Deactivate Serial Number
DELETE
Delete An existing SNMP Trap destination profile
DELETE
Delete Backup Config
DELETE
Delete Login Banner
DELETE
Delete Restore Config
DELETE
Delete Search Based Alert Config
DELETE
Delete Subnet Mapping
DELETE
Delete Subscriber
DELETE
Delete User
DELETE
Delete User Defined Event
Deprecated
DELETE
Delete User Group
DELETE
Delete Vidm Configuration
DELETE
Delete Web Proxy
POST
Disable Search Based Alert Config
POST
Disable User Defined Event
Deprecated
POST
Disable Vidm
POST
Enable Search Based Alert Config
POST
Enable User Defined Event
Deprecated
POST
Enable Vidm
GET
Get details Of An existing SNMP destination profile
GET
Get All Search Based Alert Configs
GET
Get All Subscriber
GET
Get All User Defined Events
Deprecated
GET
Get All Users
GET
Get Backup Config
GET
Get Backup Status Report
GET
Get Certificate
GET
Get Certificates Details
GET
Get Connected Clients To Web Proxy
GET
Get Infra Nodes Web Proxy
GET
Get Ip Tag
Deprecated
GET
Get Ip Tag Ids
Deprecated
GET
Get Ip Tag V2
GET
Get Licenses
GET
Get Login Banner
GET
Get Restore Config
GET
Get Restore Status Report
GET
Get Search Based Alert Config
GET
Get SNMP Engine Id
GET
Get Subnet Mappings
GET
Get Subscriber
GET
Get Tag Ids V2
GET
Get User
GET
Get User Defined Event
Deprecated
GET
Get User Group
GET
Get User Groups
GET
Get Users
GET
Get Vidm Configuration
GET
Get Web Proxies
GET
Get Web Proxy
GET
List the configured SNMP Trap destination profiles
POST
Migrate event subscriptions To other SNMP Trap destination profiles
POST
Remove Ip Tag
Deprecated
POST
Remove Tag V2
POST
Save Vidm Configuration
POST
Send Test trap To SNMP destination profile
PUT
Update An existing SNMP destination profile
PUT
Update user password
PUT
Update Backup Config
PUT
Update Login Banner
PUT
Update Search Based Alert Config
PUT
Update SNMP Engine Id
PUT
Update Subnet Mapping
PUT
Update Subscriber
PUT
Update User Defined Event
Deprecated
PUT
Update Vidm Configuration
PUT
Update Vidm User Group Role
PUT
Update Vidm User Role
PUT
Update Web Proxy
POST
Validate Connections Via Web Proxy
POST
Validate Serial Number
POST
Validate Web Proxy Migration