Replace a config element: SD.sip-nat
put
https://cloud-native-SBC-IP/config/v1/sd/sip-nat/{ElementKey}
Replace a config element: SD.sip-nat
Request
Path Parameters
-
ElementKey: string
Identifier for the element
Supported Media Types
- application/json
Root Schema : schema
Type:
object
configure sip nat across realms
Show Source
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
address-prefix: string
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-2]?[0-9]|3[0-2]))?$|^(\*)$
address prefix subject to SIP-NAT encoding <ipv4>[/<num-bits>] (e.g., 10.0.0.1/24) OR '*' to use the Realm's address prefix OR '0.0.0.0' to use the inverse of Home Realm's prefix -
domain-suffix(required): string
Minimum Length:
1
domain suffix to use in external realm (e.g., '.acme.com') -
ext-address(required): string
Minimum Length:
1
Pattern:$|^(?:(?:[0-9]{1,3}.){3}[0-9]{1,3}(?:/(?:[0-9]|[12][0-9]|3[0-2]))?|(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?::[0-9a-fA-F]{1,4}){1,7}|::)(?:/(?:[0-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8]))?$
external realm IPv4 address -
ext-proxy-address(required): string
Minimum Length:
1
Pattern:$|^(?:(?:[0-9]{1,3}.){3}[0-9]{1,3}(?:/(?:[0-9]|[12][0-9]|3[0-2]))?|(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?::[0-9a-fA-F]{1,4}){1,7}|::)(?:/(?:[0-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8]))?$
external realm proxy IPv4 address -
ext-proxy-port: integer
(int32)
Minimum Value:
1025
Maximum Value:65535
external realm proxy port -
headers: array
headers
Unique Items Required:
true
list of SIP Header names to be NAT'd -
home-address(required): string
Minimum Length:
1
Pattern:$|^(?:(?:[0-9]{1,3}.){3}[0-9]{1,3}(?:/(?:[0-9]|[12][0-9]|3[0-2]))?|(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?::[0-9a-fA-F]{1,4}){1,7}|::)(?:/(?:[0-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8]))?$
home realm IPv4 address -
home-proxy-address: string
Pattern:
^$|^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|0?[1-9][0-9]?|0?[0-9]?[1-9])(.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9]?[0-9])){2}.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|0?[0-9][0-9]?|0?[0-9]?[0-9])$
home realm proxy IPv4 address -
home-proxy-port: integer
(int32)
Minimum Value:
0
Maximum Value:65535
home realm proxy port -
host-nat-tag: string
Pattern:
^[A-Za-z0-9-]{1,63}$
URL host tag for NAT disambiguation. Default: ACME- -
parameter-name: string
URL parameter name for NAT encoding
-
realm-id(required): string
Minimum Length:
1
Pattern:^[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}$
external realm identifier -
route-home-proxy: string
Allowed Values:
[ "disabled", "enabled", "forced" ]
-
tunnel-redirect: boolean
pass back Contact URIs unchanged in redirect response
-
use-url-parameter: string
Allowed Values:
[ "none", "from-to", "phone", "all" ]
-
user-nat-tag: string
URL user tag for NAT disambiguation. Default: -acme-
Nested Schema : headers
Type:
array
Unique Items Required:
true
list of SIP Header names to be NAT'd
Show Source
Response
Supported Media Types
- application/json
200 Response
return one config element: SipNatConfig
Root Schema : schema
Type:
object
configure sip nat across realms
Show Source
-
_elementKey: string
Read Only:
true
Identifier for the element or sub-element -
address-prefix: string
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-2]?[0-9]|3[0-2]))?$|^(\*)$
address prefix subject to SIP-NAT encoding <ipv4>[/<num-bits>] (e.g., 10.0.0.1/24) OR '*' to use the Realm's address prefix OR '0.0.0.0' to use the inverse of Home Realm's prefix -
domain-suffix(required): string
Minimum Length:
1
domain suffix to use in external realm (e.g., '.acme.com') -
ext-address(required): string
Minimum Length:
1
Pattern:$|^(?:(?:[0-9]{1,3}.){3}[0-9]{1,3}(?:/(?:[0-9]|[12][0-9]|3[0-2]))?|(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?::[0-9a-fA-F]{1,4}){1,7}|::)(?:/(?:[0-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8]))?$
external realm IPv4 address -
ext-proxy-address(required): string
Minimum Length:
1
Pattern:$|^(?:(?:[0-9]{1,3}.){3}[0-9]{1,3}(?:/(?:[0-9]|[12][0-9]|3[0-2]))?|(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?::[0-9a-fA-F]{1,4}){1,7}|::)(?:/(?:[0-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8]))?$
external realm proxy IPv4 address -
ext-proxy-port: integer
(int32)
Minimum Value:
1025
Maximum Value:65535
external realm proxy port -
headers: array
headers
Unique Items Required:
true
list of SIP Header names to be NAT'd -
home-address(required): string
Minimum Length:
1
Pattern:$|^(?:(?:[0-9]{1,3}.){3}[0-9]{1,3}(?:/(?:[0-9]|[12][0-9]|3[0-2]))?|(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,7}:|(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}|(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}|(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}|(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:(?::[0-9a-fA-F]{1,4}){1,6}|:(?::[0-9a-fA-F]{1,4}){1,7}|::)(?:/(?:[0-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8]))?$
home realm IPv4 address -
home-proxy-address: string
Pattern:
^$|^(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|0?[1-9][0-9]?|0?[0-9]?[1-9])(.(25[0-5]|2[0-4][0-9]|[0-1]?[0-9]?[0-9])){2}.(25[0-5]|2[0-4][0-9]|1[0-9][0-9]|0?[0-9][0-9]?|0?[0-9]?[0-9])$
home realm proxy IPv4 address -
home-proxy-port: integer
(int32)
Minimum Value:
0
Maximum Value:65535
home realm proxy port -
host-nat-tag: string
Pattern:
^[A-Za-z0-9-]{1,63}$
URL host tag for NAT disambiguation. Default: ACME- -
parameter-name: string
URL parameter name for NAT encoding
-
realm-id(required): string
Minimum Length:
1
Pattern:^[A-Za-z0-9_][A-Za-z0-9._\-]{0,127}$
external realm identifier -
route-home-proxy: string
Allowed Values:
[ "disabled", "enabled", "forced" ]
-
tunnel-redirect: boolean
pass back Contact URIs unchanged in redirect response
-
use-url-parameter: string
Allowed Values:
[ "none", "from-to", "phone", "all" ]
-
user-nat-tag: string
URL user tag for NAT disambiguation. Default: -acme-
Nested Schema : headers
Type:
array
Unique Items Required:
true
list of SIP Header names to be NAT'd
Show Source
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" ]