Replace a config element: SD.local-policy
put
https://cloud-native-SBC-IP/config/v1/sd/local-policy/{ElementKey}
Replace a config element: SD.local-policy
Request
Path Parameters
-
ElementKey: string
Identifier for the element
Supported Media Types
- application/json
Root Schema : schema
Type:
object
configure a session request routing policy
Show Source
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
activate-time: string
Pattern:
^(((19)?[7-9][0-9])|((20)?(([0-2][0-9])|(3[0-7]))))(-((0?[1-9])|(1[0-2]))(-(([0-2]?[0-9])|(3[0-1]))([\\s:-](([0-1]?[0-9])|(2[0-3]))([:-][0-5]?[0-9]([:-][0-5]?[0-9](\\.[0-9]{1,3})?)?)?)?)?)?$
format is: 'yyyy-mm-dd hh:mm:ss.zzz' or: yyyy-mm-dd-hh:mm:ss.zzz where y=years; m=month; d=day h=hour (24-hour clock) m=minutes; s=seconds; z=milliseconds -
deactivate-time: string
Pattern:
^(((19)?[7-9][0-9])|((20)?(([0-2][0-9])|(3[0-7]))))(-((0?[1-9])|(1[0-2]))(-(([0-2]?[0-9])|(3[0-1]))([\\s:-](([0-1]?[0-9])|(2[0-3]))([:-][0-5]?[0-9]([:-][0-5]?[0-9](\\.[0-9]{1,3})?)?)?)?)?)?$
format is: 'yyyy-mm-dd hh:mm:ss.zzz' or: yyyy-mm-dd-hh:mm:ss.zzz where y=years; m=month; d=day h=hour (24-hour clock) m=minutes; s=seconds; z=milliseconds -
description: string
local policy description
-
from-address(required): array
from-address
Minimum Number of Items:
1
Unique Items Required:true
from address list -
policy-attributes: array
policy-attributes
list of policy attributes
-
policy-priority: string
Allowed Values:
[ "none", "normal", "non-urgent", "urgent", "emergency" ]
-
source-realm: array
source-realm
Unique Items Required:
true
A '*' denotes route available from all realms -
state: boolean
administrative state
-
to-address(required): array
to-address
Minimum Number of Items:
1
Unique Items Required:true
to address list
Nested Schema : from-address
Type:
array
Minimum Number of Items:
1
Unique Items Required:
true
from address list
Show Source
Nested Schema : policy-attributes
Type:
array
list of policy attributes
Show Source
-
Array of:
object LocalPolicyAttribute
list of policy attributes
Nested Schema : source-realm
Type:
array
Unique Items Required:
true
A '*' denotes route available from all realms
Show Source
Nested Schema : to-address
Type:
array
Minimum Number of Items:
1
Unique Items Required:
true
to address list
Show Source
Nested Schema : FromTo
Type:
Show Source
object
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
addr-type-prefix: string
-
name: string
-
type: string
Nested Schema : LocalPolicyAttribute
Type:
object
list of policy attributes
Show Source
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
action: string
Allowed Values:
[ "none", "replace-uri", "redirect" ]
-
app-protocol: string
Allowed Values:
[ "SIP" ]
-
carrier: string
Pattern:
^[A-Za-z0-9\!"#\$%&'\(\)\*\+-\./:;<=>\?@\[\]\^_\{\|\}~]{0,24}$|^[A-Za-z0-9\!"#\$%&'\(\)\*\+-\./:;<=>\?@\[\]\^_\{\|\}~]{1,24}$
carrier identifier -
cost: integer
(int64)
Minimum Value:
0
Maximum Value:999999999
cost (unitless) -
days-of-week: string
Pattern:
^[MTWRFSUH,-]+$
days of week policy is in effect day characters may be separated by ','s or a '-'\n M=Monday T=Tuesday W=Wednesday R=Thursday F=Friday S=Saturday U=Sunday H=Holidays\n H=holidays as defined in session router config. e.g. U-S,H meaning Saturday through Sunday and holidays -
eloc-str-lkup: boolean
enable emergency location string lookup
-
eloc-str-match: string
Pattern:
^([A-Za-z0-9_][A-Za-z0-9._\-]{0,127})?$
string used as key for emergency LRT lookup -
end-time: string
Pattern:
^(([0-9])|([0-5][0-9])|([0-1]?[0-9][0-5][0-9])|(2[0-3][0-5][0-9])|(2400))$
daily time policy is no longer in effect <0000..2400> -
lookup: string
Allowed Values:
[ "single", "multi" ]
-
media-profiles: array
media-profiles
list of media profiles
-
methods: array
methods
Unique Items Required:
true
list of SIP methods for matching with a SIP request method -
next-hop(required): string
Minimum Length:
1
Pattern:^((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])$|^((([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){6}((:[0-9a-fA-F]{1,4})|(((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){5}:((([0-9a-fA-F]{1,4}:)?[0-9a-fA-F]{1,4})|(((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){4}:((([0-9a-fA-F]{1,4}:){0,2}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:)?((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){3}:((([0-9a-fA-F]{1,4}:){0,3}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,2}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){2}:((([0-9a-fA-F]{1,4}:){0,4}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,3}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|([0-9a-fA-F]{1,4}::((([0-9a-fA-F]{1,4}:){0,5}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,4}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(::((([0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,5}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){1,7}:)|(::))$|^(([Ee][Nn][Uu][Mm])|([Ll][Dd][Aa][Pp])):[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}(;key=[A-Za-z$@&][A-Za-z._\-]{0,24})?$|^([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9]){0,1}[.])*([A-Za-z]([A-Za-z0-9-]*[A-Za-z0-9]){0,1})[.]{0,1}$|^(\*)$|^[Ll][Rr][Tt]:[A-Za-z_][A-Za-z0-9._\-]{0,23}(;key=[A-Za-z$@&][A-Za-z._\-]{0,24}(,[A-Za-z$@&][A-Za-z._\-]{0,24})?)?$|^[Ss][Aa][Gg]:[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}$
next signaling host address -
next-key: string
next stage key for Multi-Stage Local Policy lookups
-
realm: string
Pattern:
^([A-Za-z0-9_][A-Za-z0-9._\-]{0,127})?$|^[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}$
realm of next signaling. NOTE: does NOT need to be configure if matches the realm of Session Agent configured as next hop. -
start-time: string
Pattern:
^(([0-9])|([0-5][0-9])|([0-1]?[0-9][0-5][0-9])|(2[0-3][0-5][0-9])|(2400))$
daily time policy goes into effect <0000..2400> -
state: boolean
administrative state
-
terminate-recursion: boolean
terminate route recursion with this next hop
Nested Schema : methods
Type:
array
Unique Items Required:
true
list of SIP methods for matching with a SIP request method
Show Source
-
Array of:
string
Allowed Values:
[ "INVITE", "REGISTER", "PRACK", "OPTIONS", "INFO", "SUBSCRIBE", "NOTIFY", "REFER", "UPDATE", "MESSAGE", "PUBLISH" ]
Response
Supported Media Types
- application/json
200 Response
return one config element: LocalPolicy
Root Schema : schema
Type:
object
configure a session request routing policy
Show Source
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
activate-time: string
Pattern:
^(((19)?[7-9][0-9])|((20)?(([0-2][0-9])|(3[0-7]))))(-((0?[1-9])|(1[0-2]))(-(([0-2]?[0-9])|(3[0-1]))([\\s:-](([0-1]?[0-9])|(2[0-3]))([:-][0-5]?[0-9]([:-][0-5]?[0-9](\\.[0-9]{1,3})?)?)?)?)?)?$
format is: 'yyyy-mm-dd hh:mm:ss.zzz' or: yyyy-mm-dd-hh:mm:ss.zzz where y=years; m=month; d=day h=hour (24-hour clock) m=minutes; s=seconds; z=milliseconds -
deactivate-time: string
Pattern:
^(((19)?[7-9][0-9])|((20)?(([0-2][0-9])|(3[0-7]))))(-((0?[1-9])|(1[0-2]))(-(([0-2]?[0-9])|(3[0-1]))([\\s:-](([0-1]?[0-9])|(2[0-3]))([:-][0-5]?[0-9]([:-][0-5]?[0-9](\\.[0-9]{1,3})?)?)?)?)?)?$
format is: 'yyyy-mm-dd hh:mm:ss.zzz' or: yyyy-mm-dd-hh:mm:ss.zzz where y=years; m=month; d=day h=hour (24-hour clock) m=minutes; s=seconds; z=milliseconds -
description: string
local policy description
-
from-address(required): array
from-address
Minimum Number of Items:
1
Unique Items Required:true
from address list -
policy-attributes: array
policy-attributes
list of policy attributes
-
policy-priority: string
Allowed Values:
[ "none", "normal", "non-urgent", "urgent", "emergency" ]
-
source-realm: array
source-realm
Unique Items Required:
true
A '*' denotes route available from all realms -
state: boolean
administrative state
-
to-address(required): array
to-address
Minimum Number of Items:
1
Unique Items Required:true
to address list
Nested Schema : from-address
Type:
array
Minimum Number of Items:
1
Unique Items Required:
true
from address list
Show Source
Nested Schema : policy-attributes
Type:
array
list of policy attributes
Show Source
-
Array of:
object LocalPolicyAttribute
list of policy attributes
Nested Schema : source-realm
Type:
array
Unique Items Required:
true
A '*' denotes route available from all realms
Show Source
Nested Schema : to-address
Type:
array
Minimum Number of Items:
1
Unique Items Required:
true
to address list
Show Source
Nested Schema : FromTo
Type:
Show Source
object
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
addr-type-prefix: string
-
name: string
-
type: string
Nested Schema : LocalPolicyAttribute
Type:
object
list of policy attributes
Show Source
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
action: string
Allowed Values:
[ "none", "replace-uri", "redirect" ]
-
app-protocol: string
Allowed Values:
[ "SIP" ]
-
carrier: string
Pattern:
^[A-Za-z0-9\!"#\$%&'\(\)\*\+-\./:;<=>\?@\[\]\^_\{\|\}~]{0,24}$|^[A-Za-z0-9\!"#\$%&'\(\)\*\+-\./:;<=>\?@\[\]\^_\{\|\}~]{1,24}$
carrier identifier -
cost: integer
(int64)
Minimum Value:
0
Maximum Value:999999999
cost (unitless) -
days-of-week: string
Pattern:
^[MTWRFSUH,-]+$
days of week policy is in effect day characters may be separated by ','s or a '-'\n M=Monday T=Tuesday W=Wednesday R=Thursday F=Friday S=Saturday U=Sunday H=Holidays\n H=holidays as defined in session router config. e.g. U-S,H meaning Saturday through Sunday and holidays -
eloc-str-lkup: boolean
enable emergency location string lookup
-
eloc-str-match: string
Pattern:
^([A-Za-z0-9_][A-Za-z0-9._\-]{0,127})?$
string used as key for emergency LRT lookup -
end-time: string
Pattern:
^(([0-9])|([0-5][0-9])|([0-1]?[0-9][0-5][0-9])|(2[0-3][0-5][0-9])|(2400))$
daily time policy is no longer in effect <0000..2400> -
lookup: string
Allowed Values:
[ "single", "multi" ]
-
media-profiles: array
media-profiles
list of media profiles
-
methods: array
methods
Unique Items Required:
true
list of SIP methods for matching with a SIP request method -
next-hop(required): string
Minimum Length:
1
Pattern:^((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])$|^((([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){6}((:[0-9a-fA-F]{1,4})|(((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){5}:((([0-9a-fA-F]{1,4}:)?[0-9a-fA-F]{1,4})|(((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){4}:((([0-9a-fA-F]{1,4}:){0,2}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:)?((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){3}:((([0-9a-fA-F]{1,4}:){0,3}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,2}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){2}:((([0-9a-fA-F]{1,4}:){0,4}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,3}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|([0-9a-fA-F]{1,4}::((([0-9a-fA-F]{1,4}:){0,5}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,4}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(::((([0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4})|(([0-9a-fA-F]{1,4}:){0,5}((([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5])[.]){3}(([0-1]{0,1}[0-9]{0,1}|2[0-4])[0-9]|25[0-5]))))|(([0-9a-fA-F]{1,4}:){1,7}:)|(::))$|^(([Ee][Nn][Uu][Mm])|([Ll][Dd][Aa][Pp])):[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}(;key=[A-Za-z$@&][A-Za-z._\-]{0,24})?$|^([A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9]){0,1}[.])*([A-Za-z]([A-Za-z0-9-]*[A-Za-z0-9]){0,1})[.]{0,1}$|^(\*)$|^[Ll][Rr][Tt]:[A-Za-z_][A-Za-z0-9._\-]{0,23}(;key=[A-Za-z$@&][A-Za-z._\-]{0,24}(,[A-Za-z$@&][A-Za-z._\-]{0,24})?)?$|^[Ss][Aa][Gg]:[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}$
next signaling host address -
next-key: string
next stage key for Multi-Stage Local Policy lookups
-
realm: string
Pattern:
^([A-Za-z0-9_][A-Za-z0-9._\-]{0,127})?$|^[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}$
realm of next signaling. NOTE: does NOT need to be configure if matches the realm of Session Agent configured as next hop. -
start-time: string
Pattern:
^(([0-9])|([0-5][0-9])|([0-1]?[0-9][0-5][0-9])|(2[0-3][0-5][0-9])|(2400))$
daily time policy goes into effect <0000..2400> -
state: boolean
administrative state
-
terminate-recursion: boolean
terminate route recursion with this next hop
Nested Schema : methods
Type:
array
Unique Items Required:
true
list of SIP methods for matching with a SIP request method
Show Source
-
Array of:
string
Allowed Values:
[ "INVITE", "REGISTER", "PRACK", "OPTIONS", "INFO", "SUBSCRIBE", "NOTIFY", "REFER", "UPDATE", "MESSAGE", "PUBLISH" ]
404 Response
Not Found
Root Schema : ApiValidationError
Type:
Show Source
object
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
code: string
-
errors: array
errors
-
message: string
-
timestamp: string
Nested Schema : Errors
Type:
Show Source
object
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
attribute: string
-
code: string
-
message: string
-
type: string
Allowed Values:
[ "error", "fatal", "warn" ]
406 Response
Validation Failure
Root Schema : ApiValidationError
Type:
Show Source
object
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
code: string
-
errors: array
errors
-
message: string
-
timestamp: string
Nested Schema : Errors
Type:
Show Source
object
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
attribute: string
-
code: string
-
message: string
-
type: string
Allowed Values:
[ "error", "fatal", "warn" ]