REST API for Oracle Cloud Native Session Border Controller, Release 1.25.1

Retrieve a sub-element: SD.local-policy.policy-attributes

get

https://cloud-native-SBC-IP/config/v1/sd/local-policy/{ElementKey}/policy-attributes/{ElementKeySE}

Retrieve a sub-element: SD.local-policy.policy-attributes

Request

Path Parameters

ElementKey: string

Identifier for the element
ElementKeySE: string

Identifier for the sub-element

Query Parameters

revision-id: string

Integer value of saved revision, or 'latest', 'active' to show the running config, or 'staging' to show complete configuration to be activated

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

return one sub element: LocalPolicyAttribute

Root Schema : schema

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

{
    "required":[
        "next-hop"
    ],
    "properties":{
        "next-hop":{
            "description":"next signaling host address",
            "minLength":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}$",
            "type":"string"
        },
        "realm":{
            "description":"realm of next signaling. NOTE: does NOT need to be configure if matches the realm of Session Agent configured as next hop.",
            "pattern":"^([A-Za-z0-9_][A-Za-z0-9._\\-]{0,127})?$|^[A-Za-z0-9_][A-Za-z0-9._\\-]{0,127}$",
            "type":"string"
        },
        "action":{
            "$ref":"#/components/schemas/LocalPolAttrActionEnum"
        },
        "terminate-recursion":{
            "description":"terminate route recursion with this next hop",
            "type":"boolean"
        },
        "carrier":{
            "description":"carrier identifier",
            "pattern":"^[A-Za-z0-9\\!\"#\\$%&'\\(\\)\\*\\+-\\./:;<=>\\?@\\[\\]\\^_\\{\\|\\}~]{0,24}$|^[A-Za-z0-9\\!\"#\\$%&'\\(\\)\\*\\+-\\./:;<=>\\?@\\[\\]\\^_\\{\\|\\}~]{1,24}$",
            "type":"string"
        },
        "start-time":{
            "description":"daily time policy goes into effect &lt;0000..2400&gt;",
            "pattern":"^(([0-9])|([0-5][0-9])|([0-1]?[0-9][0-5][0-9])|(2[0-3][0-5][0-9])|(2400))$",
            "type":"string"
        },
        "end-time":{
            "description":"daily time policy is no longer in effect &lt;0000..2400&gt;",
            "pattern":"^(([0-9])|([0-5][0-9])|([0-1]?[0-9][0-5][0-9])|(2[0-3][0-5][0-9])|(2400))$",
            "type":"string"
        },
        "days-of-week":{
            "description":"days of week policy is in effect day characters may be separated by &#39;,&#39;s or a &#39;-&#39;\\n M&#x3D;Monday T&#x3D;Tuesday W&#x3D;Wednesday R&#x3D;Thursday F&#x3D;Friday S&#x3D;Saturday U&#x3D;Sunday H&#x3D;Holidays\\n H&#x3D;holidays as defined in session router config. e.g. U-S,H meaning Saturday through Sunday and holidays",
            "pattern":"^[MTWRFSUH,-]+$",
            "type":"string"
        },
        "cost":{
            "description":"cost (unitless)",
            "format":"int64",
            "maximum":999999999,
            "minimum":0,
            "type":"integer"
        },
        "state":{
            "description":"administrative state",
            "type":"boolean"
        },
        "app-protocol":{
            "$ref":"#/components/schemas/LPApplicationProtocolConstraintEnum"
        },
        "methods":{
            "description":"list of SIP methods for matching with a SIP request method",
            "items":{
                "$ref":"#/components/schemas/LPAttrMethodConstraintEnum"
            },
            "type":"array",
            "uniqueItems":true
        },
        "media-profiles":{
            "description":"list of media profiles",
            "items":{
                "type":"string"
            },
            "type":"array"
        },
        "lookup":{
            "$ref":"#/components/schemas/LocalPolAttrLookupEnum"
        },
        "next-key":{
            "description":"next stage key for Multi-Stage Local Policy lookups",
            "type":"string"
        },
        "eloc-str-lkup":{
            "description":"enable emergency location string lookup",
            "type":"boolean"
        },
        "eloc-str-match":{
            "description":"string used as key for emergency LRT lookup",
            "pattern":"^([A-Za-z0-9_][A-Za-z0-9._\\-]{0,127})?$",
            "type":"string"
        },
        "_elementKey":{
            "description":"Identifier for the element or sub-element",
            "readOnly":true,
            "type":"string"
        }
    },
    "description":"list of policy attributes",
    "type":"object"
}

Nested Schema : media-profiles

Type: array

list of media profiles

Show Source

Array of: string

{
    "description":"list of media profiles",
    "items":{
        "type":"string"
    },
    "type":"array"
}

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" ]

{
    "description":"list of SIP methods for matching with a SIP request method",
    "items":{
        "$ref":"#/components/schemas/LPAttrMethodConstraintEnum"
    },
    "type":"array",
    "uniqueItems":true
}

404 Response

Not Found

Root Schema : ApiValidationError

Type: object

Show Source

_elementKey: string

Read Only: true

Identifier for the element or sub-element
code: string
errors: array errors
message: string
timestamp: string

{
    "properties":{
        "timestamp":{
            "type":"string"
        },
        "code":{
            "type":"string"
        },
        "message":{
            "type":"string"
        },
        "errors":{
            "items":{
                "$ref":"#/components/schemas/Errors"
            },
            "type":"array"
        },
        "_elementKey":{
            "description":"Identifier for the element or sub-element",
            "readOnly":true,
            "type":"string"
        }
    },
    "type":"object"
}

Nested Schema : errors

Type: array

Show Source

Array of: object Errors

{
    "items":{
        "$ref":"#/components/schemas/Errors"
    },
    "type":"array"
}

Nested Schema : Errors

Type: object

Show Source

_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" ]

{
    "properties":{
        "attribute":{
            "type":"string"
        },
        "type":{
            "$ref":"#/components/schemas/TypeEnum"
        },
        "message":{
            "type":"string"
        },
        "code":{
            "type":"string"
        },
        "_elementKey":{
            "description":"Identifier for the element or sub-element",
            "readOnly":true,
            "type":"string"
        }
    },
    "type":"object"
}