Update Multicast Config (v2.1)
PUT/sdwan/v2.1/api/sites/:site_id/elements/:element_id/multicastglobalconfigs/:config_id
Update the existing multicast global config.
Request
Path Parameters
ID of the site.
ID of the element.
The multicast config ID.
- application/json
Body
Details of the Multicast config to be updated
If enabled, receives and forwards of BSM on multicast enabled interfaces. BSM is a protocol by which the device learns RPs dynamically.
The probability of a PIM interface elected as a Designated Router (DR). For Static RP, the DR Priority advertised in a PIM Hello is 1.
The ID of the multicast config.
igmp_protocol_parameters MulticastIgmpProtocolConfig
The Internet group management protocol (IGMP) version the routers regularly send queries to determine which groups are active/inactive in an appropriate LAN segment.
The number of times the ION device sent IGMP queries to the last known active host on the subnet. Default value is 3 secs.
The time interval for the ION device to respond to the IGMP query from the last known active host on the subnet. Default value is 1 sec.
The time interval between successive IGMP queries. Default value is 125 secs.
The maximum response time to the IGMP query. Default value is 100 secs.
pim_protocol_parameters MulticastPimProtocolConfig
The parameters of PIM protocol.
The time interval which a neighbor waits for a Hello message from a sender neighbor before pruning the neighbor. Default value is 105 secs.
The time interval between two PIM Hello packets. Default value is 30 secs.
The time interval between two Join/Prune messages sent to a neighbor. Default value is 60 secs.
Indicates that the first multicast packet is received i.e. the source address is received by the receiver, the DR at the receiver’s end and the RP choose the optimal path to relay information from the source to the receiver.
Responses
- 200
- 400
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
If enabled, receives and forwards of BSM on multicast enabled interfaces. BSM is a protocol by which the device learns RPs dynamically.
The probability of a PIM interface elected as a Designated Router (DR). For Static RP, the DR Priority advertised in a PIM Hello is 1.
The ID of the multicast config.
igmp_protocol_parameters MulticastIgmpProtocolConfig
The Internet group management protocol (IGMP) version the routers regularly send queries to determine which groups are active/inactive in an appropriate LAN segment.
The number of times the ION device sent IGMP queries to the last known active host on the subnet. Default value is 3 secs.
The time interval for the ION device to respond to the IGMP query from the last known active host on the subnet. Default value is 1 sec.
The time interval between successive IGMP queries. Default value is 125 secs.
The maximum response time to the IGMP query. Default value is 100 secs.
pim_protocol_parameters MulticastPimProtocolConfig
The parameters of PIM protocol.
The time interval which a neighbor waits for a Hello message from a sender neighbor before pruning the neighbor. Default value is 105 secs.
The time interval between two PIM Hello packets. Default value is 30 secs.
The time interval between two Join/Prune messages sent to a neighbor. Default value is 60 secs.
Indicates that the first multicast packet is received i.e. the source address is received by the receiver, the DR at the receiver’s end and the RP choose the optimal path to relay information from the source to the receiver.
{
"bsm_enabled": true,
"dr_priority": 0,
"id": "string",
"igmp_protocol_parameters": {
"last_member_query_count": 0,
"last_member_query_interval": 0,
"query_interval": 0,
"query_max_response_time": 0
},
"pim_protocol_parameters": {
"hello_hold_time": 0,
"hello_interval": 0,
"join_prune_interval": 0
},
"spt_switchover_enabled": true
}
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": "ELEMENT_SW_VERSION_NOT_SUPPORTED"
}
]
}
}