Update BGP Peer Config (v2.5)
PUT/v2.5/api/tenants/:tenant_id/sites/:site_id/elements/:element_id/bgppeers/:bgp_peer_id
Update the BGP peer configuration.
Request
Path Parameters
ID of the tenant.
The ID of the site.
The ID of the element.
The ID of the BGP peer.
- application/json
Body
Details of the BGP peer config to be created
Advertised default route. True or False.
Allow v4 prefixes.
Allow v6 prefixes.
bgp_config BGPConfig
The details of the BGP config.
The advertisement interval of the BGP config. The advertisement interval should be between 0 - 300 seconds and the default is 1 second.
The BGP config hold time. The hold time should be between 3 - 600 seconds.
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.
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 description of the BGP peer config. Max size = 1024.
The ID of the BGP peer config.
The name of the BGP peer config. Max size = 128.
The peer IP address.
The peer IPv6 address.
The peer type = Classic. The Peer Type option is available only for data center ION devices.
The remote AS number.
The ID of the Route Map In to filter incoming routes.
The ID of the Route Map Out to filter outgoing routes.
The ID of the Route.
Possible values: [GLOBAL
, LOCAL
]
The scope of the static route = Local or Global. If scope is local, the device does not advertise the route to other sites and if scope is global, the device advertises the route to other sites.
Shutdown
A information field that can be added to identify the BGP peer. Maximum 10 unique tags of length 1024 each are allowed.
The Update Source IP address.
The Update Source IPv6 address.
The VRF (Virtual Routing and Forwarding) ID.
Responses
- 200
- 400
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
Advertised default route. True or False.
Allow v4 prefixes.
Allow v6 prefixes.
bgp_config BGPConfig
The details of the BGP config.
The advertisement interval of the BGP config. The advertisement interval should be between 0 - 300 seconds and the default is 1 second.
The BGP config hold time. The hold time should be between 3 - 600 seconds.
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.
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 description of the BGP peer config. Max size = 1024.
The ID of the BGP peer config.
The name of the BGP peer config. Max size = 128.
The peer IP address.
The peer IPv6 address.
The peer type = Classic. The Peer Type option is available only for data center ION devices.
The remote AS number.
The ID of the Route Map In to filter incoming routes.
The ID of the Route Map Out to filter outgoing routes.
The ID of the Route.
Possible values: [GLOBAL
, LOCAL
]
The scope of the static route = Local or Global. If scope is local, the device does not advertise the route to other sites and if scope is global, the device advertises the route to other sites.
Shutdown
A information field that can be added to identify the BGP peer. Maximum 10 unique tags of length 1024 each are allowed.
The Update Source IP address.
The Update Source IPv6 address.
The VRF (Virtual Routing and Forwarding) ID.
{
"advertise_default_route": true,
"allow_v4_prefixes": true,
"allow_v6_prefixes": true,
"bgp_config": {
"adv_interval": 0,
"hold_time": 0,
"keepalive_time": 0,
"local_as_num": "string",
"md5_secret": "string",
"multi_hop_limit": 0,
"peer_auth_type": "md5",
"peer_retry_time": 0
},
"id": "string",
"name": "string",
"peer_ip": "string",
"peer_ip_v6": "string",
"peer_type": "string",
"remote_as_num": "string",
"route_map_in_id": "string",
"route_map_out_id": "string",
"router_id": "string",
"scope": "GLOBAL",
"shutdown": true,
"tags": [
"string"
],
"update_source": "string",
"update_source_v6": "string",
"vrf_context_id": "string"
}
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": "PEER_CONFIG_INVALID_PEER_IP"
},
{
"code": "BGP_CONFIG_INVALID_REMOTE_AS_NUMBER"
},
{
"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": "BGP_CONFIG_INVALID_PREFIX_ADV_TYPE"
},
{
"code": "BGP_CONFIG_INVALID_PREFIX"
},
{
"code": "INVALID_JSON_EXTRA_ATTRIBUTE"
},
{
"code": "INVALID_JSON_COMMON_ATTR_MISMATCH"
},
{
"code": "ELEMENT_NOT_ASSIGNED_TO_SITE"
},
{
"code": "INVALID_PEER_CONFIG_FOR_SPOKE"
},
{
"code": "BGP_PEER_SCOPE_NOT_SUPPORTED_BY_ELEMENT"
},
{
"code": "BGP_PEER_SCOPE_NOT_SUPPORTED_BY_ELEMENT_SW"
},
{
"code": "BGP_PEER_SHUTDOWN_NOT_SUPPORTED_BY_ELEMENT_SW"
},
{
"code": "BGP_CONFIG_INVALID_PEER_AUTH_TYPE"
},
{
"code": "BGP_CONFIG_INVALID_MD5_UNSET_REQUEST"
},
{
"code": "BGP_PEER_IP_CONFIG_NOT_SUPPORTED"
},
{
"code": "ADVERTISE_DEFAULT_ROUTE_TO_PEER_CANNOT_BE_ENABLED"
}
]
}
}