Update BGP Config (v2.3)
PUT/v2.3/api/tenants/:tenant_id/sites/:site_id/elements/:element_id/bgpconfigs/:bgp_config_id
Update the BGP configuration.
Request
Path Parameters
ID of the tenant.
The ID of the site.
The ID of the element.
The ID of the BGP config.
- application/json
Body
Details of the bgp config to be updated
The BGP config admin distance. The device sets the default Admin Distance of all learned prefixes to 20. The admin value should be in the range 1-255.
The advertisement interval of the BGP config. The advertisement interval should be between 0 - 300 seconds and the default is 1 second.
By default, graceful restart is Off. Change the default setting to On.
The BGP config hold time. The hold time should be between 3 - 600 seconds.
The BGP configuration ID.
Ipv6 Prefixes To Adv To Wan: ListIPv6Address(bcast = DENY, listMaxSize = 0, error = BGP_CONFIG_INVALID_PREFIX: IP prefix is not valid OR is not within the valid prefix range, required = false, type = GATEWAYCIDRV6)
The keep-alive time of the BGP config. The keep-alive time should be between 3 - 200 seconds.
The Local AS Number should be between 1 and 4294967295 or as A.B, where A and B are both numbers between 1 and 4294967295. If the number entered is an A.B format, the web interface displays the corresponding 32-bit conversion below the entered value. If the number entered is a 32-bit format, the web interface displays the corresponding A.B value below the entered value. The Local AS Number is mandatory.
The BGP config maximum paths. The max path value should be between 1 - 255. The default is 1.
The MD5 Secret should be between 1 and 32 characters. The default value is 0.
The BGP config multi hop limit. The multi-hop limit should be between 1 - 255 hops. The default is 1 hop.
Possible values: [md5
, none
]
The authentication type of the BGP peer.
The peer retry time should be between 0 - 65535 seconds. The default is 120 seconds.
The type of prefix advertisement; Default, Unaggregated or Auto-aggregated.
The prefix advertises to LAN.
The prefix advertises to WAN.
The IP address of the ION device. Max size = 256.
The stale path time for the BGP config. The stalepath time should be between 1 - 3600 seconds. The default is 120 seconds.
Responses
- 200
- 400
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
The BGP config admin distance. The device sets the default Admin Distance of all learned prefixes to 20. The admin value should be in the range 1-255.
The advertisement interval of the BGP config. The advertisement interval should be between 0 - 300 seconds and the default is 1 second.
By default, graceful restart is Off. Change the default setting to On.
The BGP config hold time. The hold time should be between 3 - 600 seconds.
The BGP configuration ID.
List of IPv6 prefixes advertised to WAN.
The keep-alive time of the BGP config. The keep-alive time should be between 3 - 200 seconds.
The Local AS Number should be between 1 and 4294967295 or as A.B, where A and B are both numbers between 1 and 4294967295. If the number entered is an A.B format, the web interface displays the corresponding 32-bit conversion below the entered value. If the number entered is a 32-bit format, the web interface displays the corresponding A.B value below the entered value. The Local AS Number is mandatory.
The BGP config maximum paths. The max path value should be between 1 - 255. The default is 1.
The MD5 Secret should be between 1 and 32 characters. The default value is 0.
The BGP config multi hop limit. The multi-hop limit should be between 1 - 255 hops. The default is 1 hop.
Possible values: [md5
, none
]
The authentication type of the BGP peer.
The peer retry time should be between 0 - 65535 seconds. The default is 120 seconds.
The type of prefix advertisement; Default, Unaggregated or Auto-aggregated.
The prefix advertises to LAN.
The prefix advertises to WAN.
The IP address of the ION device. Max size = 256.
The stale path time for the BGP config. The stalepath time should be between 1 - 3600 seconds. The default is 120 seconds.
{
"admin_distance": 0,
"adv_interval": 0,
"graceful_restart": true,
"hold_time": 0,
"id": "string",
"ipv6_prefixes_to_adv_to_wan": [
"string"
],
"keepalive_time": 0,
"local_as_num": "string",
"maximum_paths": 0,
"md5_secret": "string",
"multi_hop_limit": 0,
"peer_auth_type": "md5",
"peer_retry_time": 0,
"prefix_adv_type": "string",
"prefix_adv_type_to_lan": "string",
"prefixes_to_adv_to_wan": [
"string"
],
"router_id": "string",
"stalepath_time": 0
}
Bad Request
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
_error ErrorResponse[]
The error code.
The error message.
{
"_error": [
{
"code": "string",
"message": "string"
}
]
}
{
"value": {
"_error": [
{
"code": "BGP_CONFIG_INVALID_LOCAL_AS_NUMBER"
},
{
"code": "BGP_CONFIG_INVALID_KEEPALIVE_TIME"
},
{
"code": "BGP_CONFIG_INVALID_HOLD_TIME"
},
{
"code": "BGP_CONFIG_INVALID_ADV_INTERVAL"
},
{
"code": "BGP_CONFIG_INVALID_PEER_RETRY_TIME"
},
{
"code": "BGP_CONFIG_MD5_LENGTH_EXCEEDS"
},
{
"code": "BGP_CONFIG_INVALID_MULTI_HOP_LIMIT"
},
{
"code": "BGP_CONFIG_INVALID_HOLD_TIME_WITH_RESPECT_TO_KEEPALIVE_TIME"
},
{
"code": "INVALID_JSON_EXTRA_ATTRIBUTE"
},
{
"code": "INVALID_JSON_COMMON_ATTR_MISMATCH"
},
{
"code": "BGP_CONFIG_INVALID_PEER_AUTH_TYPE"
},
{
"code": "BGP_CONFIG_INVALID_MD5_UNSET_REQUEST"
}
]
}
}