Parameter | Length/Range | Description |
|---|
sipCacProfile
| 1-23 | The name of SIP Call Admission Control (CAC) profile. |
Mandatory Parameters: | | |
bandwidthLimit
| 0-2147483647 | Maximum bandwidth (in Kbps) a peer can utilize. (default is 'unlimited') |
bandwidthLimitThreshold
| 0-100 | Enter threshold value (as a percentage) to specify bandwidth utilization notification threshold. (range: 0-100 / default = 0) |
bandwidthVideoThreshold | 0-100 | Enter threshold value (as a percentage of video bandwidth) to limit video streams to a specific bandwidth to prevent video calls consuming call bandwidth otherwise needed for audio calls. (range: 0-100 / default = 0) |
callEgressAggregateEmergencyPreference
| 1-10 | Emergency call preference within the aggregate policer at Egress. (default = 10) |
callEgressAggregatePreference
| 1-10 | Call preference within the aggregate policer at Egress. (default = 1) |
callEgressBurstSize
| 1-500 | Maximum call burst size for calls to a registered endpoint or peer. (default = 1). |
callEgressEmergencyPreference
| N/A | Emergency call preference at Egress. disabled (default) enabled
|
callEgressRate
| 1-500, unlimited | Maximum egress call rate in calls per time period. (default is 'unlimited'). |
callEgressRatePeriod
| 1-10 | Time period (in seconds) over which the egress call rate applies. (default = 1). |
callIngressAggregateEmergencyPreference
| 1-10 | Emergency call preference within the aggregate policer at Ingress. (default = 10) |
callIngressAggregatePreference
| 1-10 | Call preference within the aggregate policer at Ingress. (default = 1) |
callIngressBurstSize
| 1-500 | Maximum call burst size from a peer or registered endpoint. (default = 1). |
callIngressEmergencyPreference
| N/A | Emergency call preference at Ingress. disabled (default) enabled
|
callIngressRate
| 1-500, unlimited | Maximum call arrival rate from a peer or registered endpoint per callIngressRatePeriod. (default is 'unlimited').
A value of "0" indicates that call rate policing is not applicable. |
callIngressRatePeriod
| 1-10 | Time period (in seconds) over which the callIngressRate applies. (default = 1). |
callLimit
| 0-30000, unlimited | Maximum number of active calls to and from any registered endpoint or peer (e.g. total number of ingress and egress calls). (default is 'unlimited') |
callLimitEgress
| 0-30000, unlimited | Maximum number of outbound active calls. (default is 'unlimited') |
callLimitIngress
| 0-30000, unlimited | Maximum number of inbound active calls. (default is 'unlimited') |
callLimitThreshold
| 0-100 | Call Limit utilization notification threshold, as a percentage. (default = 0). |
emergencyOversubscription
| 0-1000 | Oversubscription of calls (as a percentage) allowed for emergency calls. (default = 0). |
emergencyOversubscriptionEgress
| 0-1000 | Oversubscription of egress calls (as a percentage) allowed for emergency calls. When the baseline limit is reached, normal calls are stopped but emergency calls are allowed up to this additional percentage. (default = 10). |
emergencyOversubscriptionIngress
| 0-1000 | Oversubscription of calls (as a percentage) allowed for emergency calls. When the baseline limit is reached, normal calls are stopped but emergency calls are allowed up to this additional percentage. (default = 10). |
extendedEmergencyIpLimit
| 0-40000 | Additional number of emergency calls (expressed as a numeric value) allowed if call limit and emergency oversubscription quota are exhausted. (default = 0) |
extendedEmergencyIpLimitEgress | 0-40000 | Additional number of emergency calls (expressed as a numeric value) allowed for egress CAC group if call limit and emergency oversubscription quota are exhausted. (default = 0) |
extendedEmergencyIpLimitIngress | 0-40000 | Additional number of emergency calls (expressed as a numeric value) allowed for ingress CAC group if call limit and emergency oversubscription quota are exhausted. (default = 0) |
state
| N/A | Administrative state of this SIP CAC Profile. disabled (default) enabled
|
Optional Parameters |
aggregateMessage
| N/A | Use this object to configure the Aggregate Message policer settings listed below. egressBurstSize – Maximum Aggregate Message egress burst size. (range: 1-10000 / default = 10)egressRate – Maximum Aggregate Message egress rate. (range: 1-1000, unlimited / default is 'unlimited')egressRatePeriod – Aggregate Message egress rate period in seconds. (range: 1-10 / default = 1)ingressBurstSize – Maximum Aggregate Message ingress burst size. (range: 1-10000 / default = 10)ingressRate – Maximum Aggregate Message ingress rate. (range: 1-1000, unlimited / default is 'unlimited')ingressRatePeriod – Aggregate Message ingress rate period in seconds. (range: 1-10 / default = 1)
|
dblAggregateRej
| N/A | Use this object to Dynamically Blacklist (DBL) an endpoint based on the CAC policer reject rate using settings below. ingressBurstSize – Maximum DBL Aggregate Reject ingress burst size.(range: 1-10000 / default = 1)ingressRate – Maximum DBL Aggregate Reject ingress rate.(range: 1-1000, unlimited / default is 'unlimited')ingressRatePeriod – DBL Aggregate Reject ingress rate period in seconds.(range: 1-10 / default = 1)
|
message
| N/A | Use this object to configure the MESSAGE message in a SIP CAC profile using the settings below. egressAggregatePreference – MESSAGE preference within egress aggregate policer. (range: 1-10 / default = 1)egressBurstSize – Maximum MESSAGE egress burst size. (range: 1-10000 / default = 1)egressRate – Maximum MESSAGE egress rate. (range: 1-1000, unlimited / default is 'unlimited')egressRatePeriod – MESSAGE egress rate period in seconds. (range: 1-10 / default = 1)ingressAggregatePreference – MESSAGE preference within ingress aggregate policer. (range: 1-10 / default = 1)ingressBurstSize – Maximum MESSAGE ingress burst size. (range: 1-10000 / default = 1)ingressRate – Maximum MESSAGE ingress rate. (range: 1-1000, unlimited / default is 'unlimited')ingressRatePeriod – MESSAGE ingress rate period in seconds. (range: 1-10 / default = 1)
|
notify
| N/A | Use this object to configure the NOTIFY message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above) |
options
| N/A | Use this object to configure the OPTIONS message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above) |
otherRequests
| N/A | Use this object to configure the OTHER REQUESTS message in a SIP CAC profile using the settings below. egressAggregatePreference – OTHER REQUESTS preference within egress aggregate policer. (range: 1-10 / default = 1)egressBurstSize – Maximum OTHER REQUESTS egress burst size. (range: 1-10000 / default = 5)egressRate – Maximum OTHER REQUESTS egress rate. (range: 1-1000, unlimited / default is 'unlimited')egressRatePeriod – OTHER REQUESTS egress rate period in seconds. (range: 1-10 / default = 1)ingressAggregatePreference – OTHER REQUESTS preference within ingress aggregate policer. (range: 1-10 / default = 1)ingressBurstSize – Maximum OTHER REQUESTS ingress burst size. (range: 1-10000 / default = 5)ingressRate – Maximum OTHER REQUESTS ingress rate. (range: 1-1000, unlimited / default is 'unlimited')ingressRatePeriod – OTHER REQUESTS ingress rate period in seconds. (range: 1-10 / default = 1)
|
qoe
| N/A | Use this object to configure the Quality of Service-based routing configuration. The following parameters are used to measure signaling quality: asr – Answer Seizure Ratio measurement.asrCriticalLimit – The critical ASR limit below which call admission stops. (range: 0-70% / default = 40)defaultQosAsr – Default ASR value to use when no calls are made for a sampling period. (range: 0-100% / default = 90)majorQosAsrLimit – The major ASR limit. When breached, an INFO log is generated and trunk group stats are incremented one value. (range: 0-90% / default = 70)
clu – Call Limit Utilization measurement.cluCriticalLimit – Critical CLU limit (as percentage) below which the trunk group or peer is marked out of service for egress calls. (range: 80-100% / default = 80)
minTimeToProceed – Minimum time to wait (in seconds) before call admission resumes after peer/trunk group KPI falls below critical threshold. (range: 60-3600 seconds / default = 60)pgrd – Post Gateway Ringing Delay measurement.defaultPgrdFactor – Default PGRD value when no calls are made for a sampling period. (range: 50-10000 milliseconds / default = 500)pgrdCriticalLimit – Critical PGRD limit above which the trunk group is marked out of service, and not chosen for routing. (range: 50-10000 milliseconds / default = 2000)
- scru– Sustained Call Rate Utilization measurement.
scruCriticalLimit – SCRU KPI critical limit (as percentage) above which the trunk group/peer is not chosen for routing. (range: 80-100% / default = 80)
|
refer
| N/A | Use this object to configure the REFER message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above) |
response
| N/A | Use this object to configure the REFER message in a SIP CAC profile.(egress and ingress settings are same as 'otherRequests' parameter above) |
subscribe
| N/A | Use this object to configure the SUBSCRIBE message in a SIP CAC profile. (egress and ingress settings are same as 'message' parameter above) |