https://{target}/mmi/dsr/v4.2/
Introduction & Overview
The Oracle Communications Diameter Signaling Router Machine to Machine Interface
This Application Programming Interface (API) document describes the Machine to Machine Interface (MMI) for the Oracle Communications Diameter Signaling Router (OC-DSR, often shortened to simply DSR). The DSR MMI is a RESTful (Representational State Transfer) interface providing access to a broad range of Operations, Administration, and Maintenance (OAM) services that clients use to configure and manage the DSR. This document is the comprehensive API reference guide to the RESTful services the DSR makes available to clients through the DSR MMI.
General URI Format for DSR MMI Requests
The general format of a Uniform Resource Identifier (URI) used to send an MMI request to the DSR is:
https://{target}/mmi/dsr/{version}/{area}/{resource}[/{instance}][/{sub-resource}[/{sub-instance}]]*[/{attribute or action}]
where
- {target} is the IP address or FQDN (Fully Qualified Domain Name) of the OAM server receiving the MMI request.
- {version} is the MMI API version number. If the MMI client specifies a version that is not supported by the DSR, HTTP status code 404 is returned in the response.
- {area} is the functional area that includes the desired MMI API (areas are defined in the next paragraph).
- {resource} is the specific DSR resource being accessed - with DSR, the resource generally equates to a Managed Object (MO).
- {instance} is necessary when the client is accessing a specific instance of a resource; {instance} is the unique identifier for the resource record, and is often the instance's name attribute (although some resources use a different attribute as the unique identifier, particularly when the resource's instances don't have names).
- {sub-resource} is the specific sub-resource within the resource associated with the requested operation. It could consist of one or more tokens (e.g., /db/backup).
- {sub-instance} is only necessary when the client is accessing a specific sub-instance of a sub-resource; typically the {sub-instance} value is the name of a specific sub-resource; {sub-instance} should only appear when following a {sub-resource}.
- {attribute or action} is only necessary when the client is performing an action on a specific instance. {attribute or action} could be name of an attribute being read or updated (e.g., the administrative state) of an instance or sub-instance. Note: in this context, {action} is not one of the standard HTTP actions, but is instead one of the specific actions supported by the resource or sub-resource.
DSR MMI clients use Secure Sockets Layer (SSL) connections (HTTPS) to communicate with the target DSR.
APIs are Grouped by Functional Area
DSR MMI APIs are grouped by functional area and, as shown in section General URI Format for DSR MMI Requests, the area is one segment of the URI sent to the DSR. MMI APIs are available for the following areas of DSR functionality:
- Client Authentication (area: auth) - MMI security - authentication, authorization, and audit
- Bulk Configuration (area: bulk) - bulk export and import of system configuration
- System Administration (area: admin) - DSR network administration functions
- System Monitoring (area: mon) - access to system processes, logs, statistics, and measurements
- Topology Configuration and Management (area: topo) - insert, edit, delete, retrieval, and management of system topology resources; note that the topo area only covers management of server and network resources; application-specific resources are part of other areas (e.g., diameter)
- Core Diameter (area: diameter) - configuration establishing the DSR as a Diameter Relay Agent, including IP Front End (IPFE) behavior
- Non-Specific (area: all) - general APIs that span multiple areas of functionality
Within this API documentation, resource descriptions are organized by area, then alphabetically by the individual resource name within each area. A few resources do not have a Request block for a particular action (e.g., /diameter/mpprofileassignments GET; /mon/measurements/budget GET). This is not a mistake or oversight. In these cases, there are no valid query parameters for the API, and the Request block is simply omitted.
Both Network and Site OAM Servers Provide MMI Access
A DSR is a collection of cooperating servers arranged in a three-tiered hierarchical topology. MMI functionality is available at the top two levels of the hierarchy:
- Network - the administrative domain consisting of all DSR Sites, managed using highly available (HA) clusters of Network Operations, Administration, and Maintenance (NOAM) servers. Network-scoped functionality is hosted in this top level of the topology hierarchy and is referred to as the A-Level.
- Site - a site-level administrative domain, managed using clusters of HA Site Operations, Administration, and Maintenance (SOAM) servers. Operations performed at the SOAM are scoped to the specific SOAM (all SOAM servers in the HA cluster, plus all sub-tending C-level servers - note that these servers may not all reside at the same physical location). Site-scoped functionality is hosted in the middle layer of the topology hierarchy and is referred to as the B-Level.
The bottom level of the topology hierarchy, the C-Level, is reserved for application-level servers (DA-MPs, IPFEs, SBRs, SS7-MPs), which do not provide any administrative access. DSR MMI functionality is only available on the OAM servers.
Adding or editing a resource instance is done at either the NOAM or the SOAM, but not both. The documentation for each resource identifies whether the NOAM or SOAM is the target of an MMI request for that resource. Note that, for some resources configured at the NOAM, it is possible to retrieve the configuration - but not change it - at an SOAM. Also, status/monitoring resources like measurements, KPIs, and alarms can be retrieved at both the NOAM and SOAM. The data returned by the target OAM server is scoped to that server.
MMI Requests Are Sent to Active OAM Servers
Whenever OAM servers are deployed in High-Availability (HA) clusters, it is the server holding the HA role of active that must receive an MMI request. If a Virtual IP (VIP) is configured for the OAM cluster, requests sent to that VIP are automatically handled by the active OAM server. If an OAM server is standing alone (not part of an HA cluster), it is by default considered the active server and should be the target of client MMI requests.
RESTful Operation Overview
The DSR configuration is managed through Create, Retrieve, Update, and Delete (CRUD) actions on instances of the various resource types built into the DSR. A particular type of resource (e.g., Server, Network Element, Peer Node, Traffic Throttle Group) is also known as a Managed Object (MO), and a specific instance of a resource is known as an MO instance. Throughout this document, the term MO is used to refer either to the type or to a particular instance of a type. The intended usage should be clear from the context.
The CRUD operations are implemented using standard HTTP verbs:
- HTTP POST is used to Create a new resource instance.
- HTTP GET is used to Retrieve one or more resource instances.
- HTTP PUT is used to Update a resource instance.
- HTTP DELETE is used to Delete a resource instance.
The following sections provide a brief overview of how the CRUD operations work through the MMI using simple examples. In these examples, a simplified version of the RESTful result structure is used for illustration purposes. Refer to the schema definition in the API description for a particular resource for a complete response definition specific to that resource.
Create Pattern
To create a new instance of a resource, POST it to the collection. POST returns a response populated with the identifier of the newly created resource instance. In most cases, the resource instance identifier is simply the client-provided name of the resource. For resources that do not have a simple name field, or for which the name field is not required to be unique, a unique identifier is constructed and returned.
For example:
POST /resource/ + BODY { "name":"newInstance", "description":"an example" }
Returns the new resource ID:
"data":"newInstance",
"messages":[],
"links":[],
"status":true
Update and Delete Patterns
To update an instance of a resource, the PUT operation is used. To delete an instance, the DELETE operation is used.
There are a few common reasons why an update operation might fail:
- System updates have been disabled.
- The update data is incomplete or is some other way invalid.
- The MMI user account does not have permission to perform the requested operation for the specified resource.
- The server is currently overloaded and cannot handle a new request.
Any failure explanation(s) are returned in the messages portion of the response.
Use of Natural Identifiers
Most of the DSR MMI resource APIs use the natural identifier (typically the name field) for a resource instance. For example, the /topo/servers resource uses the server name as its natural identifier. However, in certain cases, where there is no natural identifier, a unique identifier is generated. The /route resource, for example, has no natural identifier, so one is generated at the time a new route is created.
The documentation for each resource defines what property is used as the identifier (as returned in a POST response).
Idempotent GET/PUT
A GET of a resource instance, followed by a PUT of the same resource instance, leaves the resource essentially unchanged.
Note that occasionally there are fields in a resource schema that are described as computed. These fields are always ignored on PUT. Computed fields are also ignored on initial creation requests using POST.
Some fields are read-only, and are identified as such in the JSON schemas. If included by the client in a PUT request, read-only field values are ignored by the DSR.
Some fields are not updatable. These fields must be set on initial creation via POST, and are ignored on subsequent updates.
Structured Response
Unless stated otherwise, operations place returned results in a structured container of the form:
- data (optional) - If the operation returns data, the data is placed in the data portion of the result.
- messages (optional) - If the operation returns any warnings, errors, status, or other informational data, they are placed in the messages portion of the result.
- links (optional) - If the operation returns links supporting or suggesting follow-up resources or actions, they are placed in the links portion of the result.
- status - true on success, false on failure. If false, the messages portion of the response provides details.
HTTP Status Codes
DSR operations available through the MMI API are atomic, unless stated otherwise for a specific resource. If a configuration operation does not complete successfully, the DSR is left in its original state. The RESTful operations generally available for resources, and possible return codes for each, are:
- GET - retrieve one or more items from a collection, or retrieve just a single item identified by a unique name/id
- 200 - operation successful
- 400 - bad request
- 401 - not authenticated
- 403 - not authorized
- 404 - item not found/API version not supported
- 429 - too many requests
- POST - insert a new item into a collection
- 201 - operation successful - item created
- 202 - request accepted - operation in progress
- 400 - bad request
- 401 - not authenticated
- 403 - not authorized
- 404 - API version not supported
- 500 - internal server error
- PUT - update a specific, existing item in a collection
- 200 - operation successful
- 202 - request accepted - operation in progress
- 400 - bad request
- 401 - not authenticated
- 403 - not authorized
- 404 - API version not supported
- 409 - resource state conflict
- 500 - internal server error
- DELETE - delete a specific item from a collection
- 204 - operation successful (no content is returned from a delete operation)
- 400 - bad request
- 401 - not authenticated
- 403 - not authorized
- 404 - API version not supported
- 409 - resource state conflict
- 500 - internal server error
General Behaviors
This section defines general behaviors of the DSR Machine to Machine Interface.
Read-only attributes - Most resources have one or more read-only attributes, and these are identified in the JavaScript Object Notation (JSON) schemas by the readOnly property. Read-only attributes are always returned in any GET response. Clients should not include read-only attributes in the JSON data accompanying a POST or PUT request, as the presence of read-only values never results in a DSR state change. If a POST or PUT request does include a read-only attribute value that has the correct data type (per the JSON schema), the DSR ignores the value and processes the request as if the read-only attribute were not present. If, however, a POST or PUT request includes a read-only attribute value whose data type is not correct, the DSR returns an error response. The client should fix the data type - or remove the attribute from the JSON data entirely - and re-send the request.
Simultaneous client interactions - If two or more DSR clients attempt to modify the same resource at the same time, the last-in-time request received by the DSR is the one with final impact on the state of the DSR. No error response is sent to the other clients, but the changes requested by those clients are overwritten as a result of the request received from the last-in-time client, if there is any overlap between the requests. For example, if client #1 updates the configuration of a resource instance, but client #2 subsequently deletes that same resource instance, the instance is deleted and client #1 receives no notification that the instance it just updated has been deleted.
Filtering and sorting - Generally speaking, query parameters for a collection GET operation can be used to tailor the returned results to a select subset of the collection. In this version of the API, the only tailoring somewhat widely supported is paging - returning N items beginning at a specified offset into the collection. In general, the following are not supported operations: 1) filtering results by an arbitrary named attribute, and 2) sorting the results by any arbitrary attribute. There are a few APIs - namely, for status sub-resources - that support this kind of attribute-based filtering. These are so indicated in the individual resource documentation.
Paging - Paging parameters for a collection GET operation are used to return a client-defined number of resource instances, beginning at a specified offset. In this version of the API, only resources in the Core Diameter (/diameter) area support paging. For the Core Diameter area, if paging query parameters are not supplied in the request, the number of records returned is limited to a default page size, and always begins with the first record in the configuration. If paging query parameters are supplied in the request, a success response is returned only if the requested number of instances is less than or equal to the default page size. The success response contains links for the next and previous set of records, and a message indicating the count of remaining records, when applicable. The default page size - the number of resources returned by the DSR in a GETALL request when the client does not specify a desired count in the request - is defined by the DSR and is currently set to 1000.
Default attribute values - In general, DSR provides no default value for an attribute when POSTing a new instance to the configuration. If no value is provided in the client request for an attribute that is required, the POST fails and a specific error message is returned. If no value is supplied by the client for an attribute that is not required, that attribute may or may not have a value in the configuration, depending on the specific behavior of the resource being configured.
Data validation - The data for all PUT and POST operations is validated both for syntactic and semantic correctness before the operation is allowed to proceed. If any validation errors occur, the response has a status of false, and the messages portion of the response contains one or more messages documenting the specific error details. Any unexpected operation failures also result in a status of false being returned, along with details in the messages portion of the response.
Attempting to delete a resource instance that doesn't exist - If a client attempts to delete a resource instance whose unique identifier is not present in the DSR's configuration, the DSR responds with either a 400 or 409 HTTP status code, depending on the resource type.
Handling of invalid query parameters - In this release of the DSR software, the error handling capability for invalid query parameters is limited. If a client sends a query string with one or more invalid query parameter values, the DSR's response to the request is not guaranteed to be expected.
MMI Security
With very few exceptions, access to any of the RESTful APIs supported by the DSR requires authentication. Section The Client Authentication Area describes the specifics of the authentication mechanism. In short, a client must obtain a token from the DSR by providing valid credentials. Once the client has the token, it can access any DSR MMI resource that requires authentication by providing the token in the header of the HTTP request.
Each individual resource action (GET, POST, etc.) described in this API specification includes a "secured by" designation. If the resource action requires authenticated access, this designation is "Secured by x-other". If the resource can be accessed by a client without authentication, the designation is "Secured by none". If the resource can be accessed with or without authentication, both "Secured by x-other" and "Secured by none" are present.
Note that in this release of the API, there are only two resources that can be accessed without authentication - and both of those can also be accessed with authentication.
Any resource action that includes "Secured by x-other" is rendered with a lock icon preceding the action name.
Examples
Retrieving Resource Instances: GET
There are many ways an MMI client can create the HTTP request sent to the DSR. One common tool is curl, which is available in many languages and supports several internet protocols, including HTTPS. The following example illustrates use of curl from a command line to GET all of the Capacity Configuration Sets (/diameter/capacityconfigurationsets) configured at the target DSR (here represented by 'localhost'):
curl --header 'X-Auth-Token:EFEFC54B7F19EE5B75DF' --request GET 'https://localhost/mmi/dsr/v1.0/diameter/capacityconfigurationsets'
The structured response returned by the DSR contains the following JSON data structure:
{
"data": [
{
"configurationLevel": "0",
"convergenceTime": 1000,
"ingressMpsMajorAlarmThreshold": 80,
"ingressMpsMinorAlarmThreshold": 50,
"maxIngressMps": 10000,
"name": "Default",
"reservedIngressMps": 0,
"reservedIngressMpsAbatementTime": 2000
}
],
"links": {},
"messages": [],
"status": true
}
The value of true for "status" indicates that the request was successfully processed, without any errors. In this case, there is only a single Capacity Configuration Set present in the DSR configuration, so only one instance appears in the array in the "data" section of the response.
Inserting a Resource Instance: POST
When inserting a new resource instance into the DSR configuration, the client must supply a JSON data structure, in accordance with the schema defined for the resource being inserted. In the following example, a Capacity Configuration Set (/diameter/capacityconfigurationsets) is added to the DSR represented by 'localhost' using curl from a command line:
curl --header 'X-Auth-Token:D2D588AE818739218A33' --request POST --data '{"name": "CapacityConfigurationSet1", "ingressMpsMajorAlarmThreshold": 80, "maxIngressMps": 10000, "reservedIngressMpsAbatementTime": 2000, "ingressMpsMinorAlarmThreshold": 50, "convergenceTime": 1000, "reservedIngressMps": 0}' 'https://localhost/mmi/dsr/v1.0/diameter/capacityconfigurationsets'
Assuming all supplied data is valid and the Capacity Configuration Set is successfully added to the configuration, the response from the DSR is:
{
"data":
{
"id": "CapacityConfigurationSet1",
},
"links": {},
"messages": [],
"status": true
}
The Client Authentication Area
(area: "auth")
Authentication
The auth area provides the tokens (/auth/tokens) interface for client authentication. Before performing any other operation with DSR, the client must first obtain an authentication token using the tokens interface.
The client provides credentials to identify itself, and if the credentials are successfully authenticated, DSR returns a valid token. The client then embeds the token in subsequent MMI calls using the X-Auth-Token
header.
Tokens typically expire after two hours. It is the responsibility of the client to request a fresh token before or when the previous token expires. A valid token can also be used to authenticate a client, so it is possible to replace an unexpired token with a new one that has a fresh two-hour lifetime.
A token created on any OAM server is immediately usable on that server, and becomes usable on all the OAM servers in the DSR topology after a short propagation delay (typically 3-5 seconds).
It is recommended that MMI clients re-use a valid token for up to its full two hour lifetime, rather than request a new token for each MMI non-authentication request. Requesting a new token for each non-authentication request effectively doubles the number of MMI requests the client sends to the DSR. Clients may observe decreased MMI responsiveness if a new token is requested for every non-authentication MMI request, compared to getting a token and using it for all subsequent MMI requests within its two hour lifetime.
Authorization
The token grants the bearer the same capabilities as the original MMI authentication credentials. GUI and MMI share the same user accounts and permissions database (GUI group) settings. Note that some user accounts may be limited to GUI-only or MMI-only access.
Audit Trail
All uses of a token are logged to the system security log (also shared with the GUI). Token creation and expiration generate events in the system event log.
The Topology Configuration and Management Area
(area: "topo")
The topo area provides RESTful interfaces enabling topology configuration and management for:
- Servers
- Server Groups
- Resource Domains
- Places
- Place Associations
- Network Elements
- Networks
- Network Routes
- Network Devices
- Network Service Paths
- DSCP Port Rules
- DSCP Interface Rules
The topo area covers general server/network/DSR topology configuration - the higher-level configuration that is necessary to support the mission of a DSR. Diameter-specific configuration is not part of the topo area - that is covered by the diameter area for core routing configuration, and several of the other areas, which are specific to the various applications DSR supports.
Management Services
The /topo/servers and /topo/networkelements resources provide the following management and control facilities:
- Server Status - A general summary status report for a server
- Server Management - Server management - reboot and ntpsync
- Server DB Status and Management - Database status and management (backup/restore) for a server
- Server HA Status and Management - High Availability status and management (roles) for a server
- Server Provisioning Status and Management - Data Provisioning status and management for a server
- Server Replication Status and Management - Data Replication status and management for a server
- Server Application Status and Management - Application status and management for a server
- Router Monitoring Status and Management - Gateway Router monitoring management for a network element
In general, a status request returns the current state of the resource (using GET), while a management request updates the resource (using PUT) to change its status.
The Bulk Configuration Area
(area: "bulk")
The bulk area supplies a bulk export/import facility (/bulk/configurator). The bulk export is used to extract configuration information from a DSR in bulk. Bulk export is always done per area, although multiple areas can be specified in a single MMI request. All resources included in the specified area(s) are exported together, and the results are written to an XML file located on the OAM server that received the request. Bulk export of individual resources is not supported.
Bulk import is limited to just the comagent, diameter, fabr, rbar, topo and vstp area, and is used to deploy the configuration associated with the topology rapidly for one or more DSR sites. The bulk import facility can only be used to insert (POST) configuration instances; it cannot be used to edit or delete configuration.
The import operation is non-atomic; the import operation returns a result code and a list of all the import failures providing details on why the import operation failed. At the end of the import operation, any objects that were successfully configured remain configured; any objects that failed configuration are not configured. It is up to the client to interpret any error messages and take whatever remedial action is necessary to ensure a complete and correct topology configuration.
Some common reasons why an object may fail to be successfully imported are:
- The object is already in the configuration (duplicate id).
- The syntax of the XML specification for the object is incorrect (syntax).
- Internal validation rules block the creation of the object (semantic checks).
- The server is overloaded and cannot handle a new request.
Managed objects cannot be edited or deleted using the import interface. Rather, the individual resource MMI APIs must be used (e.g., DELETE /topo/servers/{servername}).
Bootstrapping
Whenever a new server is created using either the bulk import operation or the topology server insert (POST), the new server needs to be bootstrapped to activate it and enable it to become part of the functioning system topology. Depending on how much configuration was performed on the bare metal or on the new VM by an infrastructure manager, the bootstrap may have more or less to do. The bootstrap is performed by invoking the /topo/servers/{servername}/bootstrap operation directly on the new server, passing a list of bootstrap options. Shortly after the bootstrap has completed, the other servers in the topology should recognize the new server, and the new server is configured and prepared for operation. The progress of the server can be monitored using the server status interface (/topo/servers/{servername}/status).
The System Administration Area
(area: admin)
The system administration (admin) area allows an MMI client to set up the following for the DSR network:
- Domain Name System (DNS) configuration for communication by the DSR with remote servers
- Security Certificates for secure communication between the DSR and remote servers
- Secure File Transfer Protocol (SFTP) User configuration
- Simple Network Management Protocol (SNMP) Trap manager configuration
This area also provides an API for clients to retrieve the DSR software version identifier for the software version currently running on the target OAM server.
The System Monitoring Area
(area: "mon")
The system monitoring (mon) area provides access to:
- Measurements - Historical store of system counters
- Key Performance Indicators - Point in time indicators of system health
- Alarms - Currently active alarms
- Processes - System Process resource impacts
- Tasks - Recently run or running background tasks
- Periodic Tasks - The schedule of regularly executing tasks
The system monitoring interfaces are primarily read-only, and are used to obtain status information about the system.
Scoped Data
In general, when data is requested via MMI from an OAM server, the data received is scoped to that OAM server. Therefore, a request made to the NOAM, which is at the top (A) level of the hierarchy, returns data for all servers in the DSR topology, while a request made to an SOAM (B-level) only returns data scoped to that SOAM Server Group - all SOAM servers in the HA cluster, plus all sub-tending C-level servers.
Some data (notably some measurements and alarms) is scoped to an SOAM, and is not available at the network (NOAM) level. Requests to retrieve SOAM-scoped data must be made to the specific SOAM.
Time-Ordered Data
The /measurements and /alarms services provide access to time-ordered datasets. Requests can be restricted to a specific time range (often useful in post-mortem problem analysis). If no time range is specified, the /measurements resource returns the most current measurements data set, while the alarms service returns all the currently active alarms.
Rate-Limited Data
The /measurements resource is rate-limited. To ensure that the processing costs associated with creating a measurement report do not exceed the available OAM server resources, each query of measurement data counts against a budget allocated for the request interval.
- At the start of each interval (an even 5 minute boundary), the request budget is reset.
- Each measurement query in the request interval subtracts from the budget.
- If a request is made while the budget is empty, the request is rejected.
The /measurements/budget resource can be used to determine the remaining available budget for the current request interval. Each measurement request returns the remaining budget and the cost of the request.
A measurement report cost is calculated based on the following rules:
- Each cell of reported data has a cost of one unit.
- An arrayed measurement with N populated subindexes has a cost of N units.
- Each reported time-interval multiplies the cost by the number of intervals.
- Each reported server multiplies the cost by the number of servers.
Applying these rules, a hypothetical measurement report has a report cost of 15,000,000 if it 1) has arrayed measurements with 15,000 subindexes; 2) spans 100 servers; and 3) includes 10 time-intervals.
Clients typically do not need to keep track of the measurement report budget. Each OAM server should be configured with a budget large enough to support most typical measurement report requests. If a request is submitted after the budget for an interval has been exhausted, the client receives an HTTP response of 429 - too many requests. The measurement report request should be re-submitted later.
The Core Diameter Area
(area: "diameter")
The diameter area includes all of the MMI APIs required to configure a DSR to be a Diameter Relay Agent (DRA). Diameter routing entities like Local Nodes, Peer Nodes, Connections, Route Groups, and Route Lists are all part of the diameter area. Also included is IPFE configuration, which is used to load balance Diameter Connections across a set of DA-MPs.
The discussion of the various patterns (create, update, delete) given in the Introduction & Overview section is highly relevant to the diameter area. Individual Managed Objects and collections of MOs are accessed by the client using the APIs defined for each core Diameter resource. Any operation that completes successfully returns a 2XX HTTP code, while unsuccessful operations return a 4XX HTTP code.
The All Area
(area: all)
The all area includes resources that span functional areas. For this release of the API, the object versioning interface is the only resource included in all.
Overview of Object Versioning
DSR supports the concept of object versioning, so that an MMI client can easily track the configuration changes that are made to the DSR. The configuration level is an integer value that gets incremented each time a change is made, and the configuration level integer exists 1) for the OAM server as a whole to track all changes made to the configuration database, and 2) for each individual resource type to track changes made to the instances of that particular resource.
An MMI client requests the current configuration level data from an OAM server, and uses that data to identify where changes have been made since the last time the client had a current view of the configuration. Clients use the Configuration Levels (/all/configurationlevels) URI to retrieve the current configuration level data, and the response to this request returns the server-scoped integer value (identified by "consolidated" in the response data) as well as the various resource-specific integer values for all resources supported by the OAM server (identified by the specific resource name).
Object versioning via configuration level is not yet included by all the functional areas within the DSR MMI API specification. For this release, only the diameter area supports configuration level.
The Fabr Area
(area: "fabr")
The fabr area includes all of the MMI APIs required to configure a Full Address Based Resolution application. Full Address Based Resolution entities like Supported Applications, Routing Exceptions, Default Destinations, Address Resolutions, and System Options are all part of the fabr area.
The discussion of the various patterns (create, update, delete) given in the Introduction & Overview section is highly relevant to the fabr area. Individual Managed Objects and collections of MOs are accessed by the client using the APIs defined for each core Fabr resource. Any operation that completes successfully returns a 2XX HTTP code, while unsuccessful operations return a 4XX HTTP code.
The ComAgent Area
(area: "comagent")
The comagent area includes all of the MMI APIs required to configure Communication Agent (ComAgent) including infrastructure features and services for enabling inter-server communication. ComAgent entities like Remote Servers, Connection Groups and Routed Services are all part of the ComAgent area.
The discussion of the various patterns (create, update, delete) given in the Introduction & Overview section is highly relevant to the ComAgent area. Individual Managed Objects and collections of MOs are accessed by the client using the APIs defined for each core ComAgent resource. Any operation that completes successfully returns a 2XX HTTP code, while unsuccessful operations return a 4XX HTTP code.
The Radius Area
(area: "radius")
The radius area includes all of the MMI APIs required to configure entities like Ingress Status Server Configuration Sets, Shared Secret Configuration Sets, Message Conversion Configuration Sets, Message Authenticator Configuration Sets, NAS Nodes, and Radius Options are all part of the radius area.
The discussion of the various patterns (create, update, delete) given in the Introduction & Overview section is highly relevant to the radius area. Individual Managed Objects and collections of MOs are accessed by the client using the APIs defined for each core Radius resource. Any operation that completes successfully returns a 2XX HTTP code, while unsuccessful operations return a 4XX HTTP code.
The Scef Area
(area: "scef")
The scef area includes all of the MMI APIs required for SCEF configuration which includes the following resources.
- NIDD Configuration Sets: A set of configurations that apply to NIDD call flows.
- APN Configuration Sets: A set of configurations that are associated to an APN, The APN is associated to a SCS/AS Profile.
- Monitoring Event Configuration Sets: A set of configurations for SCEF Monitoring Events.
- Device Triggering Configuration Sets: A set of configurations for Device Triggering to create a SCS/AS.
- SCS Application Servers: Service Capability Server (SCS) enables Applications to access and use functionality provided by Service Components over standardized interfaces (APIs).
- System Options: SCEF related user configurable Options.
- Access Control Lists: A set of configurations to support multi tenancy Access Control, DRMP and Flow/Overload Control during notification callback.
- Access Control Rules: A set of configurations to create an Access Control Rule.
- Access Control Associations: This is used to associate the Rules with an Access Control List.
The Eir Area
(area: "eir")
The eir area includes all of the MMI APIs required to configure the EIR application. EIR application provides a mechanism that will allow the network operators to prevent stolen or disallowed handsets from accessing the network.
The Common Security Area
(area: "commonsecurity")
The commonsecurity area includes all of the MMI APIs required to configure the CCNDC Mapping and Neighboring Countries. The Common Security application provides a mechanism that to add and remove tables for CCNDC Mapping and Neighboring Countries.
Change Log
API Version v4.2 ( DSR Release 8.5.0.2.0_92.7.0 )
Backward Compatible Changes
- Added new attribute for Message Copy Configuration Sets in Options API (diameter/options).
- Added new attribute for Rf Message Copy Feature Enabled in Options API (diameter/options).
- Added new attributes - AAA Route List, MPN Route List and UMF Route List in Options API (diameter/options).
- Added new resource Rf Message Copy (diameter/rfmessagecopy).
- Initial Creation for area: Radius.
- Added Bulk Export and Import support for all Radius managed objects.
- Added new resource SMS Proxy Options(vstp/smsproxyoptions).
- Added new resource SMS Proxy SMSC Status(vstp/smscstatus).
Non-Backward Compatible Changes
- None
Non-Interface Changes
- None
API Version v4.1 ( DSR Release 8.5.0.0.0_90.11.0 )
Backward Compatible Changes
- Added new resource Country Latitude Longitude (/commonsecurity/countrylonglats).
- Added new resource Cat2 Imsi(/vstp/cat2imsi).
- Added new resource Cat2 Gta(vstp/cat2gta).
- Added new resource Security Log Config(/vstp/securitylogconfig).
- Added new resource Accounting Measurement Options(/vstp/accountingmeasurementoptions).
Non-Backward Compatible Changes
- Changed Uri of CCMCCMappings (/commonsecurity/ccmccmappings).
Non-Interface Changes
- None
API Version v3.1 ( DSR Release 8.4.0.3.0_85.17.0 )
Backward Compatible Changes
- Supporting both Bulk Export and Bulk Import for Diameter, Fabr, Rbar, Vstp and Comagent.
- Added Bulk Export support for Connection Groups and Remote Servers MO.
- Initial Creation for area: commonsecurity.
- Added new resource Exceptions (/commonsecurity/neighboringcountries).
- Added Bulk Export support for all MO's.
- Added Bulk Export support for all MO's.
- Added Bulk Export support for all MO's.
- Added new resource NPP Service Rule Sets (/vstp/nppservicerulesets).
- Added new resource Common Screening Lists (/vstp/commonscreeninglists).
- Added new resource Mate Stps (/vstp/matestps).
- Added Bulk Export support for all MO's.
- Added new resource Mtp2 Options (/vstp/mtp2options).
- Added new resource Interface Mappings (/vstp/interfacemappings).
- Added new resource MTP2Board (/vstp/mtp2board).
- Added new resource NPP Action Sets (/vstp/nppactionsets).
- Added new resource PPS Options (/vstp/ppsoptions).
- Added new resource NPP Services (/vstp/nppservices).
- Added new resource IDPR Options (/vstp/idproptions.
Non-Backward Compatible Changes
- None
Non-Interface Changes
- None
API Version v3.0 ( DSR Release 8.4.0.0.0_84.15.0 )
Backward Compatible Changes
- Added new resource Users (admin/users).
- Added new resource Groups (admin/groups).
- Added new resource Sessions (admin/sessions).
- Added new resource Mp Profiles (diameter/mpprofiles).
- Added new resource Dynamic Peer Discovery-Realms(diameter/dpdrealms).
- Added new resource Dynamic Peer Discovery-DNS Sets(diameter/dpddnssets).
- Added new resource Dynamic Peer Discovery-Discovery Attributes(diameter/dpdattributesets).
- Added new resource Peer Node Alarm Groups (/diameter/peernodealarmgroups).
- Updated Peer Node Status (/diameter/peernodes/status). Added new attributes Peer Node Alarm Group Name and Alarm Ids.
- Updated Options (/diameter/options). Added new attribute Alarm Group Feature Enabled.
- Added new resource Connection Alarm Groups (/diameter/connectionalarmgroups).
- Updated Connection Status (/diameter/connections/status). Added new attributes Connection Alarm Group Name and Alarm Ids.
- Added new resource Topology Hiding Trusted Network Lists (diameter/trustednetworklists).
- Added new resource Path Topology Hiding Configuration Sets (diameter/pathtopologyhidingcfgsets).
- Added new resource S6a/S6d Hss Topology Hiding Configuration Sets (diameter/hsstopologyhidingcfgsets).
- Added new resource MME/SGSN Topology Hiding Configuration Sets (diameter/mmetopologyhidingcfgsets).
- Added new resource S9 PCRF Topology Hiding Configuration Sets (diameter/pcrftopologyhidingcfgsets).
- Added new resource AF/pCSCF Topology Hiding Configuration Sets (diameter/aftopologyhidingcfgsets).
- Added new resource Topology Hiding Protected Networks (diameter/protectednetworks).
- Added new resource View History (mon/alarmseventshistory).
- Added new resource View Trap Log (mon/alarmseventstraplog).
- Initial Creation for area: sbr.
- MMI support for Monitoring Location Area
- Updated Remote Signaling Points (/vstp/remotesignalingpoints). Added new optional attributes aliasPointCode1, aliasPointCode2, aliasPointCode1DomainType and aliasPointCode2DomainType.
- Updated M3RL Options (/vstp/m3rloptions). Added new optional attributes cnvAInat, cnvCgda, cnvCgdi, cnvCgdn, cnvCgdn24, cnvCgdn16, cnvClgItu, gtCnvDflt, itun16TcTimer and sparePCSupportEnabled.
- Updated Sccp Options (/vstp/sccpoptions). Added optional attribute itun16ScmgEnabled ( Itun16 Scmg Enabled).
- Updated GTA (/vstp/globaltitleaddresses). Added new optional attributes - gtmodName (GTT Modification Name), ccgt (Cancel called global title indicator), cgGtmod (Calling party GT modification indicator).
- Updated Link Sets (/vstp/linksets). Added new optional attribute enableCgGtmod.
- Updated GTT Actions (/vstp/gttactions). Added new optional attributes gtmodName (Global title modification identifier).
- Added new resource GTT Modification (/vstp/gttmods).
- Added new resource Home Entity (/vstp/homeentities).
- Added new resource MNP Options (/vstp/sccpmnpoptions).
- Added new resource SCCP Service Selectors (/vstp/sccpserviceselectors).
- Added new resource Sccp Applications (/vstp/sccpapplications).
- Added new resource Sccp Applications Status (/vstp/sccpapplicationstatus).
- Added new resource Sccp Applications Admin State(/vstp/sccpapplicationadminstate).
- Added new resource Default Conversions(/vstp/defaultconversions).
- Added new resource MTP Screening Rules(/vstp/mtpscreeningrules).
- Added new resource GTT Modification (/vstp/gttmods).
- Added new resource MTP Screen Sets (/vstp/mtpscreensets).
- Added new resource Sccp Loopsets (/vstp/sccploopsets).
Non-Backward Compatible Changes
- Updated Local Signaling Points with support for Multiple Point Code(TPC/SPC/CPC).
Non-Interface Changes
- None
API Version v2.1 ( DSR Release 8.3.0.0.0_83.15.0 )
Backward Compatible Changes
- Initial Creation for area: comagent.
- Added new resource Maintenance Application(diameter/applications).
- Added new resource Maintenance Signaling Firewall (diameter/signalingfirewalls).
- Added new resource Maintenance Peer DAMP Status (/diameter/peerdamps).
- Added new resource Maintenance Peer DAMP Connectivity Status (/diameter/peerdampconnectivity).
- Added new resource Maintenance DAMP Server Hostname Status (/diameter/dampserverhostnames).
- Added new resource Capacity Summary (/diameter/capacitysummary).
- Added new resource Peer Node Status (/diameter/peernodes/status).
- Added new resource Route Group Status (/diameter/routegroups/status).
- Added new resource Shared Traffic Throttle Group (/diameter/sharedtrafficthrottlegroups).
- Added new resource Connection Capactiy Dashboard (/diameter/connectioncapacitydashboard).
- Added new resource Route Lists Status (/diameter/routelists/status).
- Initial Creation for area: eir.
- Initial Creation for area: fabr.
- Initial Creation for area: scef.
Non-Backward Compatible Changes
- None
Non-Interface Changes
- None
API Version v2.0 ( DSR Release 8.2.0.0.0_82.15.0 )
Backward Compatible Changes
- Added new resource Mcc Mnc (diameter/mccmncs).
- Added new resource Mcc Mnc Mappings (/diameter/mccmncmappings).
- Added new resource Reserved Mcc Ranges (/diameter/reservedmccranges).
- Added new resource Common Application Options (/diameter/commonapplicationoptions).
- Initial Creation for area: rbar.
- Updated GTT Selectors (/vstp/gttselectors). Added new optional attributes - linksetName (Link Set Name), cdgttsn (CdPA GTT Set Name), cggttsn (CgPA GTT Set Name), cgssn (CgPA subsystem number), selid(Selector ID). Marked older attribute gttSetName from required to optional.
- Updated Link Sets (/vstp/linksets). Added new optional attribute gttmode.
- Updated SCCP Options (/vstp/sccpoptions). Added new optional attributes dfltfallback and dfltgttmode.
- Updated GTA (/vstp/globaltitleaddresses). Added new optional attributes - acn (Application Context Name), actsn (Action Set Name), cdselid (Called Party Selector Id), cdssn (Start Called Party SubSytem Number), cgpc (Calling Party Point Code), cgpcaction (Calling Party Point Code Actions), cgselid (Calling Party Selector Id), cgssn (Start Calling Party SubSytem Number), defmapvr (Default MAP Version), domain (Domain), ecdssn (End Called Party SubSytem Number), ecgssn (End Calling Party SubSytem Number), emapaddr (MAP based End Address), fallback (Fallback), family (Family), opc (Origin Point Code), opcode (OpCode), opcsn (Origin Point Code Set Name), optsn (Optional Set Name), pkgtype (Package Type), routingIndicator (Routing Indicator), smapaddr (MAP based Start Address).
- Updated GTT Sets (/vstp/gttsets). Added new optional attribute npsn (Not Present Set Name). Added new enum values - Cdssn, Cdgta, Cgpc, Cgssn, Imsi, Msisdn, Opc, Opcode - for attribute gttSetType.
- Added new resource GTT Action Sets (/vstp/gttactionsets).
- Added new resource GTT Actions (/vstp/gttactions).
Non-Backward Compatible Changes
- Maximum tuple (mapSetId + RSP + SSN) allowed for mapset and mrnset (mrnSetId + RSP) is reduced to 6000 and 3000 respectively.
- Allowed range value for mapSetId and mrnSetId is reduced to 6000 and 1500 respectively. This is applicable for /vstp/mapsets, /vstp/mrnsets, /vstp/gttaddresses and /vstp/gttactions.
- GTT Load sharing features - FGTTLS, IGTTLS and WGTTLS are enabled by default.
Non-Interface Changes
- None
API Version v1.1 ( DSR Release 8.1.0.0.0_81.20.0 )
Backward Compatible Changes
- Updated Software Versions (/admin/softwareversions). Added new attribute - hostname.
- Added new resource Application Priority Options (/diameter/applicationpriorityoptions).
- Updated Connection Configuration Sets (/diameter/connectionconfigurationsets). Added new optional attributes - cl1MinPriorityAllowed, cl2MinPriorityAllowed, cl3MinPriorityAllowed.
- Updated Pending Transaction Limit Configuration Sets (/diameter/pendingtransactionlimitingconfigurationsets). Added new optional attribute - pendConvergenceTime.
- Updated Egress Throttle Group Status (/diameter/egressthrottlegroupstatus). Added new optional attributes - averagePendTransHoldTime, egressRequestRate, numberOfPendingTransactions, offeredTrafficRate, percentTransDiverted, targetEtr.
- Updated Options (/diameter/options). Added new optional attributes - congestionDiscardPolicy, etgMode, ngnPs16PriorityAdminStateEnabled, ngnPsAnswerPriorityMode, ngnPsMaxPriority0Allowed, ngnPsMaxPriority1Allowed, ngnPsMaxPriority2Allowed.
- Updated Options (/diameter/options). Added new readonly attributes - ngnPsMaxNormalRequestPriority.
- Updated Options (/diameter/options). Extended the range - New range for ngnPsMinimumAnswerPriority is [P0,P3,P14,P15], New range for ngnPsMinimumInviolablePriority is [P3,P4,P15,P99].
- Updated Peer Route Rule (/diameter/peerrouterules). Extended the range - New range for msgPriority is [Nc,Pr0,Pr1,Pr2,Pr3,Pr4,Pr5,Pr6,Pr7,Pr8,Pr9,Pr10,Pr11,Pr12,Pr13,Pr14,Pr15].
- Updated Message Priority Configuration Sets (/diameter/messagepriorityconfigurationsets). Max value for priority is increased to 15.
- Added new optional attribute isTrafficMeasuringEnabled in Route Group (/diameter/routegroups).
- Added new optional attribute answerOnAnyEnabledConnection in Peer Node (/diameter/peernodes).
- Added new MP Profiles - Gen9V2_Relay, Gen9V2_Database, and Gen9V2_Session in MP Profile Assignment (/diameter/mpprofileassignments).
- Updated Message Priority Configuration Sets (/diameter/messagepriorityconfigurationsets). Max value for priority is increased to 15.
- Added new resource Signaling Ip Addresses (/diameter/signalingipaddresses).
- Updated Network Devices (/topo/networkdevices). Marked attributes as read only - persistentDhclient, hwAddr, ethtoolOpts, ethtoolAccelOpts.
- Initial Creation for area: vstp.
Non-Backward Compatible Changes
- None
Non-Interface Changes
- Updated descriptions against Onset and Abatement Threshold Levels in Pending Transaction Limiting Configuration Sets (/diameter/pendingtransactionlimitingconfigurationsets).
- Updated descriptions against Onset and Abatement Threshold Levels in Rate Limiting Configuration Sets (/diameter/ratelimitingconfigurationsets).
API Version v1.0 ( DSR Release 8.0.0.0.0_80.25.0 )
Backward Compatible Changes
- Initial Creation for area: admin.
- Initial Creation for area: all.
- Initial Creation for area: appworks.
- Initial Creation for area: auth.
- Initial Creation for area: bulk.
- Initial Creation for area: diameter.
- Initial Creation for area: mon.
- Initial Creation for area: topo.
Non-Backward Compatible Changes
- None
Non-Interface Changes
- None
Admin: Authorized IPs
The IP addresses that have permission access can be added or deleted on the Authorized IPs page. If a connection is attempted from an IP address that does not have permission to access, a notification will appear.
IP Addresses can be created, edited, and retrieved at the NOAM, but can also be retrieved from any active SOAM server. No IP Addresses configuration changes can be made at any SOAM except enabling the IP.
/admin/authorizedips
get /admin/authorizedips
Returns all IP Addresses configuration instances.
Target Server: NOAM or SOAM
Secured by x-other
post /admin/authorizedips
Adds a new Authorized IP instance to the Administration configuration. The new instance must be associated with an OAM Server Group that does not already have an instance configured for it.
Target Server: NOAM
Secured by x-other
/admin/authorizedips/{ipaddress}
get /admin/authorizedips/{ipaddress}
Returns the details for the specified Authorized IP configuration instance. If the named instance does not exist in the Administration configuration, an error message is returned within the HTTP response.
Target Server: NOAM or SOAM
Secured by x-other
delete /admin/authorizedips/{ipaddress}
Deletes the specified Authorized IP configuration instance.
Target Server: NOAM
Secured by x-other
/admin/authorizedips/{ipaddress}/disablefeat
put /admin/authorizedips/{ipaddress}/disablefeat
Disables specified authorized ips. Disables specified authorized ips.
Target Server: NOAM
/admin/authorizedips/{ipaddress}/enablefeat
put /admin/authorizedips/{ipaddress}/enablefeat
Enables all Authorized IPs from being sent by the OAM (if so configured).
Target Server: NOAM
Admin: DNS Configuration
The DNS Configuration resource allows a client to configure a DNS for use by DSR servers. A DNS is configured in one of two modes: global (e.g., network-wide), or per-site. When configured as global, the same configuration is used by the active NOAM and each active SOAM within the DSR network. If the DNS configuration mode is set to Global, all of the site-specific DNS Configurations are deleted from the DSR; only the single, global DNS Configuration is retained. When configured as per-site, unique DNS configurations can be created for each site, as well as for the NOAM.
Each DNS configuration instance is identified by the OAM Network Element (/topo/servergroups) to which is corresponds. So in global mode, there is just one instance, and it is identified by the configured name of the NOAM Network Element. In per-site mode, there can be up to one instance per configured OAM Network Element. In the current release of DSR, MMI clients can retrieve only a single DSR Configuration instance at a time.
DNS configuration is created, edited, and retrieved at the NOAM, but can also be retrieved from any active SOAM server. No DNS configuration changes can be made at any SOAM.
/admin/dnsconfigurations
post /admin/dnsconfigurations
Adds a new DNS Configuration instance to the DSR configuration. The new instance must be associated with an OAM Network Element that does not already have an instance configured for it.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/dnsconfiguration/dnsconfiguration.json",
"properties": {
"configurationMode": {
"description": "When set to Global, the DNS configuration instance applies to every OAM Network Element (/topo/networkelements) in the DSR network - the NOAM Network Element and each SOAM Network Element. Setting the configuration mode to Global is only allowed on the NOAM Network Element and doing so will remove all DNS configurations configured on non-NOAM Network Elements. When set to PerSite, each OAM Network Element can have its own unique DNS configuration instance.",
"enum": [
"Global",
"PerSite"
],
"type": "string"
},
"domainSearchOrder": {
"description": "A list of up to six valid domain names, in priority order. If a lower priority search domain is set without the corresponding higher priority search domain set, the DSR automatically elevates the search domain to the highest available (unset) priority.",
"properties": {
"searchDomain1": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain2": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain3": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain4": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain5": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain6": {
"description": "A valid domain name",
"type": "string"
}
},
"type": "object"
},
"nameServer": {
"description": "The address of an external DNS name server. This value must be valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"networkElementName": {
"description": "The name of an OAM Network Element to which this DNS configuration instance applies. Must be either the NOAM Network Element name, or the name of one of the configured SOAM Network Elements.",
"maximum": 32,
"minimum": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"configurationMode",
"nameServer",
"networkElementName"
],
"type": "object"
}
Example
{
"configurationMode": "Global",
"domainSearchOrder": {
"searchDomain1": "test1.com",
"searchDomain2": "test2.com",
"searchDomain3": "test3.com"
},
"nameServer": "10.250.50.121",
"networkElementName": "NOAM_NE"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/admin/dnsconfigurations/{networkElementName}
get /admin/dnsconfigurations/{networkElementName}
Returns the details for the specified DNS configuration instance. The instance is specified by the name of the OAM Network Element to which it corresponds. If the named instance does not exist in the DSR configuration, an error message is returned within the HTTP response.
Secured by x-other
Request
URI Parameters
- networkElementName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/items/dnsconfigurationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/dnsconfiguration/dnsconfiguration.json",
"properties": {
"configurationMode": {
"description": "When set to Global, the DNS configuration instance applies to every OAM Network Element (/topo/networkelements) in the DSR network - the NOAM Network Element and each SOAM Network Element. Setting the configuration mode to Global is only allowed on the NOAM Network Element and doing so will remove all DNS configurations configured on non-NOAM Network Elements. When set to PerSite, each OAM Network Element can have its own unique DNS configuration instance.",
"enum": [
"Global",
"PerSite"
],
"type": "string"
},
"domainSearchOrder": {
"description": "A list of up to six valid domain names, in priority order. If a lower priority search domain is set without the corresponding higher priority search domain set, the DSR automatically elevates the search domain to the highest available (unset) priority.",
"properties": {
"searchDomain1": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain2": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain3": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain4": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain5": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain6": {
"description": "A valid domain name",
"type": "string"
}
},
"type": "object"
},
"nameServer": {
"description": "The address of an external DNS name server. This value must be valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"networkElementName": {
"description": "The name of an OAM Network Element to which this DNS configuration instance applies. Must be either the NOAM Network Element name, or the name of one of the configured SOAM Network Elements.",
"maximum": 32,
"minimum": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"configurationMode",
"nameServer",
"networkElementName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationMode": "Global",
"domainSearchOrder": {
"searchDomain1": "test1.com",
"searchDomain2": "test2.com",
"searchDomain3": "test3.com"
},
"nameServer": "10.250.50.121",
"networkElementName": "NOAM_NE"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/dnsconfigurations/{networkElementName}
Updates the specified DNS configuration instance. The instance is specified by the name of the OAM Network Element to which it corresponds.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- networkElementName: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/dnsconfiguration/dnsconfiguration.json",
"properties": {
"configurationMode": {
"description": "When set to Global, the DNS configuration instance applies to every OAM Network Element (/topo/networkelements) in the DSR network - the NOAM Network Element and each SOAM Network Element. Setting the configuration mode to Global is only allowed on the NOAM Network Element and doing so will remove all DNS configurations configured on non-NOAM Network Elements. When set to PerSite, each OAM Network Element can have its own unique DNS configuration instance.",
"enum": [
"Global",
"PerSite"
],
"type": "string"
},
"domainSearchOrder": {
"description": "A list of up to six valid domain names, in priority order. If a lower priority search domain is set without the corresponding higher priority search domain set, the DSR automatically elevates the search domain to the highest available (unset) priority.",
"properties": {
"searchDomain1": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain2": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain3": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain4": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain5": {
"description": "A valid domain name",
"type": "string"
},
"searchDomain6": {
"description": "A valid domain name",
"type": "string"
}
},
"type": "object"
},
"nameServer": {
"description": "The address of an external DNS name server. This value must be valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"networkElementName": {
"description": "The name of an OAM Network Element to which this DNS configuration instance applies. Must be either the NOAM Network Element name, or the name of one of the configured SOAM Network Elements.",
"maximum": 32,
"minimum": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"configurationMode",
"nameServer",
"networkElementName"
],
"type": "object"
}
Example
{
"configurationMode": "Global",
"domainSearchOrder": {
"searchDomain1": "test1.com",
"searchDomain2": "test2.com",
"searchDomain3": "test3.com"
},
"nameServer": "10.250.50.121",
"networkElementName": "NOAM_NE"
}
delete /admin/dnsconfigurations/{networkElementName}
Deletes the specified DNS configuration instance. The instance is specified by the name of the OAM Network Element to which it corresponds.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- networkElementName: required (string)
Admin: General Options
General Options is a collection of parameters that govern various aspects of the AppWorks operation.
There is a single instance of this resource, which contains all of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All Options configuration is done at the NOAM. Only Get operation is permissible on SOAM.
/admin/generaloptions
get /admin/generaloptions
Returns the set of current values for the Options.
Target Server: NOAM and SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/items/generaloptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/generaloption/generaloption.json",
"properties": {
"certificateDomainName": {
"description": "Certificate Domain Name is used for Single Sign On and HTTPS certificates. (e.g. yourdomain.com) Can only contain alphanumeric, hyphen and decimal characters.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"disabledAccount": {
"description": "Disabled account contains message displayed when attempting to login to a disabled account.",
"maxLength": 512,
"pattern": "^([A-Za-z][A-Za-z_ .]*)$",
"default": "This account has been disabled.",
"type": "string"
},
"durabilityAdminState": {
"description": "Gives the information about durability state of the system. Various state of range stands for : 1 (NO disk, data is replicated to the active NO only), 2 (NO pair, data is replicated to both the active and standby NOs), 3 (NO Disaster Recovery data is replicated to the active or standby NOs, as well as the secondary NO)",
"enum": [
"NO disk",
"NO pair",
"NO DRNO"
],
"default": "NO disk",
"type": "string"
},
"enableHaSafeguards": {
"description": "Informs about the whether HA Role change Validation is enabled or not. If true, depicts HA safeguards are enabled otherwise false. Typical value is true.",
"maximum": 1,
"minimum": 0,
"type": "integer"
},
"enableMmiAccess": {
"description": "Informs about the whether MMI access on servers is enabled or not. If true, depicts MMI access on servers are enabled otherwise false. Typical value is true.",
"maximum": 1,
"minimum": 0,
"type": "integer"
},
"exportDataSpaceReplace": {
"description": "Export Data Space Replace is the character use to replace a space in the export group name when added to the export directory or filename.",
"maxLength": 512,
"pattern": "^([a-zA-Z_0-9]*)$",
"type": "string"
},
"exportFileCompressionType": {
"description": "Gives the information about compression algorithm used when export data files are initially created.Range number stnads for various algorithm of compression: 0(None), 1(gzip), 2(bzip2).",
"enum": [
"none",
"gzip",
"bzip2"
],
"default": "gzip",
"type": "string"
},
"failedLoginMessage": {
"description": "Failed Login Message contains message displayed on failed login.",
"maxLength": 512,
"pattern": "^([A-Za-z][A-Za-z_ .]*)$",
"default": "Login failed",
"type": "string"
},
"ipAuthDeniedMessage": {
"description": "IP Authorization Denied Message contains configurable portion of Denied message.",
"maxLength": 512,
"pattern": "^([A-Za-z][A-Za-z_ .]*)$",
"default": "Access denied.",
"type": "string"
},
"lastLoginExpiration": {
"description": "Gives the information about the number of days of inactivity before a user account is disabled. The account is disabled the next time the user logs in using valid credentials. The account must be re-enabled by the guiadmin user or any user with admin group permissions. Entering a value of 0 indicates never disable.",
"maximum": 200,
"minimum": 0,
"type": "integer"
},
"lockOutWindow": {
"description": "Gives the information about the amount of time (in minutes) in which exceeding the Maximum Consecutive Failed Login attempts causes an account to be disabled. The account must be re-enabled by the guiadmin user or any user with admin group permissions. Entering a value of 0 indicates the window is unlimited and disables the Maximum Consecutive Failed Login attempts setting.",
"maximum": 40,
"minimum": 0,
"type": "integer"
},
"loginMessage": {
"description": "Login Message contains configurable portion of Login message seen on login screen.",
"maxLength": 512,
"pattern": "^([A-Za-z][A-Za-z_ .]*)$",
"default": "Welcome to the Oracle System Login.",
"type": "string"
},
"minPasswordDifference": {
"description": "Gives the information about the minimum character difference between passwords.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"minPasswordLength": {
"description": "Gives the information about the minimum number of valid characters required for a user password.",
"maximum": 16,
"minimum": 8,
"type": "integer"
},
"maxConsecutiveFailedLogin": {
"description": "Gives the information about the maximum number of failed login attempts that can occur within the Lock out window before the account is disabled. The account must be re-enabled by the guiadmin user or any user with admin group permissions. Entering a value of 0 indicates never disable.",
"maximum": 10,
"minimum": 0,
"type": "integer"
},
"maxPasswordHistory": {
"description": "Gives the information about the maximum number of passwords maintained in a history list before reuse of a password is allowed. Entering a value of 0 in this field means that no password history is applied and the same password can be reused.",
"maximum": 10,
"minimum": 0,
"type": "integer"
},
"maxRecordsPerPage": {
"description": "Gives the information about maximum number of records to display per page.",
"maximum": 100,
"minimum": 10,
"type": "integer"
},
"passwordexpiration": {
"description": "Gives the information about the number of calendar days passwords stay active. Entering a value of 0 in this field means that passwords never expire. Note that the expiration is retroactive: if the expiration is set to 30 and it has been 45 days since the password was last changed, the password is now expired.",
"maximum": 90,
"minimum": 0,
"type": "integer"
},
"samlEnabled": {
"description": "Gives the information about SAML authentication of users (Security Assertion Markup Language).",
"maximum": 1,
"minimum": 0,
"type": "integer"
},
"samlInactivityTimeout": {
"description": "Gives the information about time (in minutes) before SAML authenticated sessions expire.",
"maximum": 3600,
"minimum": 0,
"type": "integer"
},
"singleSignOnSessionLife": {
"description": "Gives the information about the maximum session life (in minutes) for a Single-Sign-On session.",
"maximum": 3600,
"minimum": 0,
"type": "integer"
},
"siteUpgradeBulkAvailability": {
"description": "Gives the information about the Site based upgrade availability for bulk upgrade of MP groups(0 = none, 1 = 50%, 2 = 66%, 3 = 75%). Note: This cannot be changed when any site upgrade is active.",
"enum": [
"none",
"50%",
"66%",
"75%"
],
"default": "50%",
"type": "string"
},
"siteUpgradeSoamMethod": {
"description": "Gives the information about Site based upgrade SOAM method. Note: This cannot be changed when any site upgrade is active. Bulk upgrade will upgrade all non-active SOAM servers together.",
"enum": [
"serial",
"bulk"
],
"default": "bulk",
"type": "string"
},
"welcomeMessage": {
"description": "Welcome Message contains Welcome message seen after successful login. Note: You can customize the message appearance by using HTML code; for example, <br> to insert a line break.",
"maxLength": 512,
"type": "string"
}
},
"required": [
"durabilityAdminState",
"enableHaSafeguards",
"enableMmiAccess",
"exportFileCompressionType",
"lastLoginExpiration",
"lockOutWindow",
"minPasswordDifference",
"minPasswordLength",
"maxConsecutiveFailedLogin",
"maxPasswordHistory",
"maxRecordsPerPage",
"passwordexpiration",
"samlEnabled",
"samlInactivityTimeout",
"singleSignOnSessionLife",
"siteUpgradeBulkAvailability",
"siteUpgradeSoamMethod"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"certificateDomainName": "domainname.com",
"disabledAccount": "This account has been disabled.",
"durabilityAdminState": 1,
"enableHaSafeguards": 1,
"enableMmiAccess": 1,
"exportDataSpaceReplace": "_"
"exportFileCompressionType": 1,
"failedLoginMessage": "Login Failed",
"ipAuthDeniedMessage": "Access Denied.",
"lastLoginExpiration": 0,
"lockOutWindow": 30,
"loginMessage": "Welcome to the Oracle System Login.",
"minPasswordDifference": 0,
"minPasswordLength": 8,
"maxConsecutiveFailedLogin": 5,
"maxPasswordHistory": 3,
"maxRecordsPerPage": 20,
"passwordexpiration": 90,
"samlEnabled": false,
"samlInactivityTimeout": 120,
"singleSignOnSessionLife": 120,
"siteUpgradeBulkAvailability": 1,
"siteUpgradeSoamMethod": 1,
"welcomeMessage": "This is the user-defined welcome message.<br>It can be modified using the 'General Options' item under the 'Administration' menu.<br><br><b>Login Name: guiadmin<br><b>Last Login Time: 2018-12-05 00:36:34<br><b>Last Login IP: 10.176.254.76<br><b>Recent Failed Login Attempts: 0"
},
"messages":
[
],
"links":
{
},
"status":
true
}
Admin: LDAP Authentication
The Single sign-on (SSO) can be configured to work either along or without a shared LDAP authentication server. If an LDAP server is configured, SSO can be configured to require remote (LDAP) authentication wrt SSO access on an account by account basis. The user account (guiadmin) cannot be configured to use remote (LDAP) authentication.
If multiple LDAP servers are configured, the first available server of the list is used to perform the authentication. Secondary servers are only used only when the first server is unreachable.
If the system is not using a DNS server or IP address with respect to the LDAP server, the LDAP server must be added to the /etc/hosts file.
For each ldap authentication resource the following action is provided:
LDAP Authentication configuration is created, edited, and retrieved at the active NOAM, but can be reported and testserver from any active SOAM server also. No LDAP Authentication configuration changes can be made at any SOAM.
/admin/ssoldaps
get /admin/ssoldaps
Returns all LDAP Authentication instances.
Target Server: NOAM or SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/ssoldapCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/ssoldap/ssoldap.json",
"notInsertable": ["UUID"],
"properties": {
"accountCanonicalForm": {
"description": "It is the form of canonicalization which the provided username takes on.",
"enum": [
"Backslash",
"E-Mail",
"Traditional"
],
"type": "string"
},
"accountFilterFormat": {
"description": "It is the user account search filter.",
"maxLength": 100,
"minLength": 1,
"pattern": "^(([A-Za-z0-9_]*([A-Za-z][A-Za-z0-9_]*)){1,100})$",
"type": "string"
},
"accountDomainName": {
"description": "It refers to domain name of the LDAP server.",
"maxLength": 20,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,19}[a-zA-Z0-9]\\.){1,20}(?!0-9+)[a-zA-Z0-9]{1,20}$",
"type": "string"
},
"accountDomainNameShort": {
"description": "It is the short and capitalised version of the account domain name that is without extension.",
"maxLength": 10,
"pattern": "^[A-Z0-9]{1,10}$",
"type": "string"
},
"baseDn": {
"description": "Base Domain Name is the directory path of the user being authenticated.",
"maxLength": 100,
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"type": "string"
},
"bindRequireDn": {
"description": "Bind Require Domaine Name tells whether the LDAP authentication bind requires a username in Domain Name form. By default it is disabled",
"default": false,
"type": "boolean"
},
"followReferrals": {
"description": "Follow Referrals tells whether to follow referral or not. By default it is disabled/ignored",
"enum": [
"Follow",
"Ignore"
],
"default": "Ignore",
"type": "string"
},
"hostName": {
"description": "It is the unique name for the server. It can be either a valid IPv4 or IPv6 address or a valid hostname. Hostname must be unique and case-insensitive.",
"maxLength": 255,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$|^([A-Za-f0-9]{6}-[a-f0-9]{8})$",
"type": "string"
},
"port": {
"description": "Port that the LDAP servers can be accessed by the host machine.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
},
"Server_ID": {
"description": "Sso Ldap Authentication Identifier (*computed*). It is a unique indentifer for Sso Ldap which gets generated automatically",
"example": "12",
"readOnly": true
},
"username": {
"description": "User name for the account DN lookups.",
"maxLength": 15,
"pattern": "^[a-zA-Z0-9]{0,15}$",
"type": "string"
}
},
"required": [
"accountCanonicalForm",
"baseDn",
"hostName",
"port"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"accountCanonicalForm": "Backslash",
"accountFilterFormat": "access",
"accountDomainName": "oracle.com",
"accountDomainNameShort": "ORACLE",
"baseDn": "/var/tklc/",
"bindRequireDn": false,
"followReferrals": "IGNORE",
"hostName": "localhostname1",
"port": 389,
"username": "guiadmin"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
post /admin/ssoldaps
Adds a LDAP Authentication instance to the LDAP Authentication configuration.
Target Server: NOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/ssoldap/ssoldap.json",
"notInsertable": ["UUID"],
"properties": {
"accountCanonicalForm": {
"description": "It is the form of canonicalization which the provided username takes on.",
"enum": [
"Backslash",
"E-Mail",
"Traditional"
],
"type": "string"
},
"accountFilterFormat": {
"description": "It is the user account search filter.",
"maxLength": 100,
"minLength": 1,
"pattern": "^(([A-Za-z0-9_]*([A-Za-z][A-Za-z0-9_]*)){1,100})$",
"type": "string"
},
"accountDomainName": {
"description": "It refers to domain name of the LDAP server.",
"maxLength": 20,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,19}[a-zA-Z0-9]\\.){1,20}(?!0-9+)[a-zA-Z0-9]{1,20}$",
"type": "string"
},
"accountDomainNameShort": {
"description": "It is the short and capitalised version of the account domain name that is without extension.",
"maxLength": 10,
"pattern": "^[A-Z0-9]{1,10}$",
"type": "string"
},
"baseDn": {
"description": "Base Domain Name is the directory path of the user being authenticated.",
"maxLength": 100,
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"type": "string"
},
"bindRequireDn": {
"description": "Bind Require Domaine Name tells whether the LDAP authentication bind requires a username in Domain Name form. By default it is disabled",
"default": false,
"type": "boolean"
},
"followReferrals": {
"description": "Follow Referrals tells whether to follow referral or not. By default it is disabled/ignored",
"enum": [
"Follow",
"Ignore"
],
"default": "Ignore",
"type": "string"
},
"hostName": {
"description": "It is the unique name for the server. It can be either a valid IPv4 or IPv6 address or a valid hostname. Hostname must be unique and case-insensitive.",
"maxLength": 255,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$|^([A-Za-f0-9]{6}-[a-f0-9]{8})$",
"type": "string"
},
"port": {
"description": "Port that the LDAP servers can be accessed by the host machine.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
},
"Server_ID": {
"description": "Sso Ldap Authentication Identifier (*computed*). It is a unique indentifer for Sso Ldap which gets generated automatically",
"example": "12",
"readOnly": true
},
"username": {
"description": "User name for the account DN lookups.",
"maxLength": 15,
"pattern": "^[a-zA-Z0-9]{0,15}$",
"type": "string"
}
},
"required": [
"accountCanonicalForm",
"baseDn",
"hostName",
"port"
],
"type": "object"
}
Example
{
"accountCanonicalForm": "Backslash",
"accountFilterFormat": "access",
"accountDomainName": "oracle.com",
"accountDomainNameShort": "ORACLE",
"baseDn": "/var/tklc/",
"bindRequireDn": false,
"followReferrals": "IGNORE",
"hostName": "localhostname1",
"port": 389,
"username": "guiadmin"
}
Response
HTTP status code 201
/admin/ssoldaps/{Server_ID}
get /admin/ssoldaps/{Server_ID}
Returns the details of the specified LDAP Authentication instance. If the named instance does not exist, an error message is returned within the HTTP response.
Target Server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- Server_ID: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/items/ssoldapItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/ssoldap/ssoldap.json",
"notInsertable": ["UUID"],
"properties": {
"accountCanonicalForm": {
"description": "It is the form of canonicalization which the provided username takes on.",
"enum": [
"Backslash",
"E-Mail",
"Traditional"
],
"type": "string"
},
"accountFilterFormat": {
"description": "It is the user account search filter.",
"maxLength": 100,
"minLength": 1,
"pattern": "^(([A-Za-z0-9_]*([A-Za-z][A-Za-z0-9_]*)){1,100})$",
"type": "string"
},
"accountDomainName": {
"description": "It refers to domain name of the LDAP server.",
"maxLength": 20,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,19}[a-zA-Z0-9]\\.){1,20}(?!0-9+)[a-zA-Z0-9]{1,20}$",
"type": "string"
},
"accountDomainNameShort": {
"description": "It is the short and capitalised version of the account domain name that is without extension.",
"maxLength": 10,
"pattern": "^[A-Z0-9]{1,10}$",
"type": "string"
},
"baseDn": {
"description": "Base Domain Name is the directory path of the user being authenticated.",
"maxLength": 100,
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"type": "string"
},
"bindRequireDn": {
"description": "Bind Require Domaine Name tells whether the LDAP authentication bind requires a username in Domain Name form. By default it is disabled",
"default": false,
"type": "boolean"
},
"followReferrals": {
"description": "Follow Referrals tells whether to follow referral or not. By default it is disabled/ignored",
"enum": [
"Follow",
"Ignore"
],
"default": "Ignore",
"type": "string"
},
"hostName": {
"description": "It is the unique name for the server. It can be either a valid IPv4 or IPv6 address or a valid hostname. Hostname must be unique and case-insensitive.",
"maxLength": 255,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$|^([A-Za-f0-9]{6}-[a-f0-9]{8})$",
"type": "string"
},
"port": {
"description": "Port that the LDAP servers can be accessed by the host machine.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
},
"Server_ID": {
"description": "Sso Ldap Authentication Identifier (*computed*). It is a unique indentifer for Sso Ldap which gets generated automatically",
"example": "12",
"readOnly": true
},
"username": {
"description": "User name for the account DN lookups.",
"maxLength": 15,
"pattern": "^[a-zA-Z0-9]{0,15}$",
"type": "string"
}
},
"required": [
"accountCanonicalForm",
"baseDn",
"hostName",
"port"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"accountCanonicalForm": "Backslash",
"accountFilterFormat": "access",
"accountDomainName": "oracle.com",
"accountDomainNameShort": "ORACLE",
"baseDn": "/var/tklc/",
"bindRequireDn": false,
"followReferrals": "IGNORE",
"hostName": "localhostname1",
"port": 389,
"username": "guiadmin"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/ssoldaps/{Server_ID}
Updates the specified LDAP Authentication configuration instance.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- Server_ID: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/ssoldap/ssoldap.json",
"notInsertable": ["UUID"],
"properties": {
"accountCanonicalForm": {
"description": "It is the form of canonicalization which the provided username takes on.",
"enum": [
"Backslash",
"E-Mail",
"Traditional"
],
"type": "string"
},
"accountFilterFormat": {
"description": "It is the user account search filter.",
"maxLength": 100,
"minLength": 1,
"pattern": "^(([A-Za-z0-9_]*([A-Za-z][A-Za-z0-9_]*)){1,100})$",
"type": "string"
},
"accountDomainName": {
"description": "It refers to domain name of the LDAP server.",
"maxLength": 20,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,19}[a-zA-Z0-9]\\.){1,20}(?!0-9+)[a-zA-Z0-9]{1,20}$",
"type": "string"
},
"accountDomainNameShort": {
"description": "It is the short and capitalised version of the account domain name that is without extension.",
"maxLength": 10,
"pattern": "^[A-Z0-9]{1,10}$",
"type": "string"
},
"baseDn": {
"description": "Base Domain Name is the directory path of the user being authenticated.",
"maxLength": 100,
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"type": "string"
},
"bindRequireDn": {
"description": "Bind Require Domaine Name tells whether the LDAP authentication bind requires a username in Domain Name form. By default it is disabled",
"default": false,
"type": "boolean"
},
"followReferrals": {
"description": "Follow Referrals tells whether to follow referral or not. By default it is disabled/ignored",
"enum": [
"Follow",
"Ignore"
],
"default": "Ignore",
"type": "string"
},
"hostName": {
"description": "It is the unique name for the server. It can be either a valid IPv4 or IPv6 address or a valid hostname. Hostname must be unique and case-insensitive.",
"maxLength": 255,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$|^([A-Za-f0-9]{6}-[a-f0-9]{8})$",
"type": "string"
},
"port": {
"description": "Port that the LDAP servers can be accessed by the host machine.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
},
"Server_ID": {
"description": "Sso Ldap Authentication Identifier (*computed*). It is a unique indentifer for Sso Ldap which gets generated automatically",
"example": "12",
"readOnly": true
},
"username": {
"description": "User name for the account DN lookups.",
"maxLength": 15,
"pattern": "^[a-zA-Z0-9]{0,15}$",
"type": "string"
}
},
"required": [
"accountCanonicalForm",
"baseDn",
"hostName",
"port"
],
"type": "object"
}
Example
{
"accountCanonicalForm": "Backslash",
"accountFilterFormat": "access",
"accountDomainName": "oracle.com",
"accountDomainNameShort": "ORACLE",
"baseDn": "/var/tklc/",
"bindRequireDn": false,
"followReferrals": "IGNORE",
"hostName": "localhostname1",
"port": 389,
"username": "guiadmin"
}
delete /admin/ssoldaps/{Server_ID}
Deletes the specified LDAP Authentication instance. The instance is specified by the hostname to which it corresponds.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- Server_ID: required (string)
/admin/ssoldaps/{Server_ID}/moveup
get /admin/ssoldaps/{Server_ID}/moveup
Moves Up LDAP Authentication instances, if so configured.
Target Server: NOAM or SOAM
Request
URI Parameters
- Server_ID: required (string)
Response
HTTP status code 202
Successfully moves up LDAP Authenticated instances.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/taskItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/task/task.json",
"type" :"object",
"required": [
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Task identifier"
},
"hostname": {
"type": "string",
"description": "Server running task"
},
"name": {
"type": "string",
"description": "Task Name"
},
"status": {
"type": "string",
"description": "Admin Status",
"enum": [ "Running", "Stopped", "Paused", "Completed", "Exception" ]
},
"startTime": {
"description": "The task start time",
"type": "string",
"example":"2015-08-12T14:46:13-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"updateTime": {
"description": "The task status last update time",
"type": "string",
"example":"2015-08-12T14:47:43-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"progress": {
"description": "The task progress",
"type": "integer",
"example":"100",
"minimum" : 0,
"maximum" : 100
},
"details": {
"description": "Task Details",
"type": "string",
"example": "Lots of interesting details..."
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "ruby-noa:0",
"server": "ruby-noa",
"name": "joe",
"status": "completed",
"startTime": "2015-09-28T13:33:05-04:00",
"updateTime": "2015-09-28T13:34:11-04:00",
"progress": 100,
"details": "Lots of task details..."
},
"messages":
[
],
"links":
{
},
"status":
true
}
/admin/ssoldaps/{Server_ID}/movedown
get /admin/ssoldaps/{Server_ID}/movedown
Moves Down LDAP Authentication instances, if so configured.
Target Server: NOAM or SOAM
Request
URI Parameters
- Server_ID: required (string)
Response
HTTP status code 202
Successfully moves down LDAP Authenticated instances.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/taskItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/task/task.json",
"type" :"object",
"required": [
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Task identifier"
},
"hostname": {
"type": "string",
"description": "Server running task"
},
"name": {
"type": "string",
"description": "Task Name"
},
"status": {
"type": "string",
"description": "Admin Status",
"enum": [ "Running", "Stopped", "Paused", "Completed", "Exception" ]
},
"startTime": {
"description": "The task start time",
"type": "string",
"example":"2015-08-12T14:46:13-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"updateTime": {
"description": "The task status last update time",
"type": "string",
"example":"2015-08-12T14:47:43-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"progress": {
"description": "The task progress",
"type": "integer",
"example":"100",
"minimum" : 0,
"maximum" : 100
},
"details": {
"description": "Task Details",
"type": "string",
"example": "Lots of interesting details..."
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "ruby-noa:0",
"server": "ruby-noa",
"name": "joe",
"status": "completed",
"startTime": "2015-09-28T13:33:05-04:00",
"updateTime": "2015-09-28T13:34:11-04:00",
"progress": 100,
"details": "Lots of task details..."
},
"messages":
[
],
"links":
{
},
"status":
true
}
/admin/ssoldaps/{Server_ID}/testserver
put /admin/ssoldaps/{Server_ID}/testserver
Tries to make connection with the selected hostname instance of LDAP server being authenticated.
Target Server: NOAM
Request
URI Parameters
- Server_ID: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/ssoldaptestserver/ssoldaptestserver.json",
"properties": {
"password": {
"description": "Passwords for an LDAP authentication account must be between 8 and 16 characters.The password must also contain 3 of these 4 types of characters:numeric, lowercase alpha, uppercase alpha, special character (!@#$%^&*?~).",
"minLength": 8,
"maxLength": 16,
"pattern": "^((?=.*[0-9])(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%^&*?~]).{8,16})$",
"type": "string"
}
},
"required": [
"password"
],
"type": "object"
}
Example
{
"password": "xxxx"
}
Response
HTTP status code 200
Admin: Groups
A group is a collection of one or more users who need to access the same set of functions. Permissions are assigned to the group for each application function. All users assigned to the same group have the same permissions for the same functions. In other words, you cannot customize permissions for a user within a group.
You can assign a user to multiple groups. You can add, delete, and modify groups except for the Pre-defined User and Group that come with the system.
For non-administrative users, a group with restricted access is essential. To prevent non-administrative users from setting up new users and groups, be sure User and Group in the Administration Permissions section are unchecked. Removing the check marks from the Global Action Permissions section does not prevent groups and users from being set up. Figure: Global Action and Administration Permissions displays these sections of the Group Administration page.
Group configuration is created, edited, and retrieved at the NOAM, but can also be retrieved from any active SOAM server. No Group configuration changes can be made at any SOAM.
/admin/groups
get /admin/groups
Returns all group accounts configured at the DSR.
Target Server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/groupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/group/group.json",
"properties": {
"description": {
"description": "Describe the group.",
"minLength": 0,
"maxLength": 64,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "Name of the group to be associated with the resource set.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"permissions": {
"description": "Assign access permission of the group.The Global Action Permissions section allows you to control all insert (Global Data Insert), edit (Global Data Edit), and delete (Global Data Delete) functions on all MOs (except User and Group).By default, all groups have permissions to view application data and log files.",
"type": "array"
}
},
"required": [
"groupname"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"description": "Administrator Group",
"groupname": "SuperGroup",
"permissions": [
{
"Edit": true,
"View": true,
"id": "APS_Options"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_User administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "LDAP_Auth"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "export_server_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DNS Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Resource Domains"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_NE Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Services"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Server Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Server Group Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Places"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Network"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Group administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DSCP"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Device"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Route"
},
{
"Insert": true,
"View": true,
"id": "Bulk Configuration"
},
{
"View": true,
"id": "View Active Alarms"
},
{
"View": true,
"id": "View Event History"
},
{
"Delete": true,
"View": true,
"id": "APS_Session management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Certificate Management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "admin_ipauth_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "SFTP Users"
},
{
"View": true,
"id": "admin_versions_report"
},
{
"Edit": true,
"Manage": true,
"View": true,
"id": "APS_Upgrade"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_SNMP"
}
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /admin/groups
Adds a new group account. The new groupname must be unique within the DSR configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/group/group.json",
"properties": {
"description": {
"description": "Describe the group.",
"minLength": 0,
"maxLength": 64,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "Name of the group to be associated with the resource set.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"permissions": {
"description": "Assign access permission of the group.The Global Action Permissions section allows you to control all insert (Global Data Insert), edit (Global Data Edit), and delete (Global Data Delete) functions on all MOs (except User and Group).By default, all groups have permissions to view application data and log files.",
"type": "array"
}
},
"required": [
"groupname"
],
"type": "object"
}
Example
{
"description": "Administrator Group",
"groupname": "SuperGroup",
"permissions": [
{
"Edit": true,
"View": true,
"id": "APS_Options"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_User administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "LDAP_Auth"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "export_server_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DNS Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Resource Domains"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_NE Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Services"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Server Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Server Group Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Places"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Network"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Group administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DSCP"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Device"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Route"
},
{
"Insert": true,
"View": true,
"id": "Bulk Configuration"
},
{
"View": true,
"id": "View Active Alarms"
},
{
"View": true,
"id": "View Event History"
},
{
"Delete": true,
"View": true,
"id": "APS_Session management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Certificate Management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "admin_ipauth_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "SFTP Users"
},
{
"View": true,
"id": "admin_versions_report"
},
{
"Edit": true,
"Manage": true,
"View": true,
"id": "APS_Upgrade"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_SNMP"
}
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/admin/groups/{groupname}
get /admin/groups/{groupname}
Returns the configuration details for the specified group account. If the specified group does not exist in the NOAM's configuration, an error message is returned within the HTTP reponse.
Target Server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- groupname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/group/group.json",
"properties": {
"description": {
"description": "Describe the group.",
"minLength": 0,
"maxLength": 64,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "Name of the group to be associated with the resource set.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"permissions": {
"description": "Assign access permission of the group.The Global Action Permissions section allows you to control all insert (Global Data Insert), edit (Global Data Edit), and delete (Global Data Delete) functions on all MOs (except User and Group).By default, all groups have permissions to view application data and log files.",
"type": "array"
}
},
"required": [
"groupname"
],
"type": "object"
}
Example
{
"data":
{
"description": "Administrator Group",
"groupname": "SuperGroup",
"permissions": [
{
"Edit": true,
"View": true,
"id": "APS_Options"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_User administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "LDAP_Auth"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "export_server_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DNS Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Resource Domains"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_NE Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Services"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Server Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Server Group Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Places"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Network"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Group administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DSCP"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Device"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Route"
},
{
"Insert": true,
"View": true,
"id": "Bulk Configuration"
},
{
"View": true,
"id": "View Active Alarms"
},
{
"View": true,
"id": "View Event History"
},
{
"Delete": true,
"View": true,
"id": "APS_Session management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Certificate Management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "admin_ipauth_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "SFTP Users"
},
{
"View": true,
"id": "admin_versions_report"
},
{
"Edit": true,
"Manage": true,
"View": true,
"id": "APS_Upgrade"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_SNMP"
}
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/groups/{groupname}
Updates the configuration for the group account. If the provided group data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- groupname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/group/group.json",
"properties": {
"description": {
"description": "Describe the group.",
"minLength": 0,
"maxLength": 64,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "Name of the group to be associated with the resource set.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"permissions": {
"description": "Assign access permission of the group.The Global Action Permissions section allows you to control all insert (Global Data Insert), edit (Global Data Edit), and delete (Global Data Delete) functions on all MOs (except User and Group).By default, all groups have permissions to view application data and log files.",
"type": "array"
}
},
"required": [
"groupname"
],
"type": "object"
}
Example
{
"description": "Administrator Group",
"groupname": "SuperGroup",
"permissions": [
{
"Edit": true,
"View": true,
"id": "APS_Options"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_User administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "LDAP_Auth"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "export_server_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DNS Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Resource Domains"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_NE Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Services"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Server Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Server Group Configuration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Places"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Network"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "APS_Group administration"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "DSCP"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Device"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Configure Route"
},
{
"Insert": true,
"View": true,
"id": "Bulk Configuration"
},
{
"View": true,
"id": "View Active Alarms"
},
{
"View": true,
"id": "View Event History"
},
{
"Delete": true,
"View": true,
"id": "APS_Session management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "Certificate Management"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "admin_ipauth_index"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"View": true,
"id": "SFTP Users"
},
{
"View": true,
"id": "admin_versions_report"
},
{
"Edit": true,
"Manage": true,
"View": true,
"id": "APS_Upgrade"
},
{
"Delete": true,
"Edit": true,
"Insert": true,
"Manage": true,
"View": true,
"id": "APS_SNMP"
}
]
}
delete /admin/groups/{groupname}
Deletes the specified group from the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- groupname: required (string)
Admin: Data Export(Remote Servers)
The Administration Remote Servers resource provides access to configuration and management of remote servers for Automated Performance Data Export (APDE).
The API provides for query, insertion, edit, and deletion of a remote server.
For each remote server resource the following actions are provided:
- test - Test transfer to the given resource, generating an export file if necessary
- transfer - Initiate a standard file transfer separate from the scheduled transfer
- keyexchange - Push the OAM public keys to the remote server using the provided password
For users that do not wish to provide a password the /sshkeys API is supported, which returns the public keys for all relevant servers of the user used for pushing files. This allows for manual configuration of the authorized_keys file on the target remote server. A remoteservers/{uuid}/test POST should be called after manually placing keys, to confirm that the system can successfully transfer files.
/admin/remoteservers
get /admin/remoteservers
Retrieves the configuration data for all remote servers configured at the OAM server where the request is sent.
Filtering by Network Element and Hostname is supported. By default only the remote servers for the local network element are included.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- scope_type[]: (one of Server, ServerGroup, ResourceDomain, PlaceAssociation, Place, NetworkElement - repeat: true)
The scope type
Names the type of server collection to be filtered on.
Example:
?scope_type[]=Server&scope_name[]=mynoa
- scope_name[]: (string - repeat: true)
the scope name
Names the specific server collection to be filtered on.
Example:
?scope_type[]=ServerGroup&scope_name[]=NO_SG
- filter_name[]: (string - repeat: true)
The field being matched
filter parameters are used in sets and multiple sets may be provided. for example:
filter_name=hostname&filter_op=EQUAL&filter_values=ruby-noa
defines a hostname filter matching the value ruby-noa.
Example:
filter_name[]=hostname
- filter_op[]: (one of EQUAL, NOT_EQUAL, LESS_THAN, LESS_THAN_EQUAL, GREATER_THAN, GREATER_THAN_EQUAL, IS_NULL, IS_NOT_NULL, LIKE, NOT_LIKE, IN, NOT_IN, BETWEEN, NOT_BETWEEN - repeat: true)
The match operation (operator)
Example:
filter_op[]=IN
- filter_values[]: (string - repeat: true)
The matched value(s)
Use comma seperators when providing multiple values.
Example:
filter_values[]=mynoa,mynob
- filter_andOr[]: (one of AND, OR - default: AND - repeat: true)
The logical operator to join this filter to the previous filter
Typically, multiple filter sets are anded together; use the andOr option to explicitly set the andOr value when multiple filter sets are used.
Example:
filter_andOr[]=OR
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/remoteserverCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/remoteserver/remoteserver.json",
"type": "object",
"required": ["taskName", "hostname", "username", "transferFrequency"],
"notInsertable": ["UUID"],
"properties": {
"taskName": {
"type": "string",
"description": "Periodic Task name",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 1,
"maxLength": 40
},
"taskDescription": {
"type": "string",
"description": "Periodic Task description",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 0,
"maxLength": 255
},
"hostname": {
"type": "string",
"maxLength": 255,
"description": "Resolvable hostname or IPv4/IPv6 address of the remote server. Valid hostname characters are alphanumeric, minus sign, and period.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$"
},
"username": {
"type": "string",
"maxLength": 32,
"description": "Username to access the remote server. Valid characters are alphanumeric",
"pattern": "^[0-9a-zA-Z-]{1,32}$"
},
"directory": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_\\.\\-]*[\\/A-Za-z][A-Za-z0-9_\\.\\-]*)$",
"description": "Target absolute path on the export server where files are transferred. If none is provided, /home/{username} is used. Maximum length is a 4096-character string. Valid characters are alphanumeric (a-z, A-Z, and 0-9), dash, underscore, period, and forward slash."
},
"rsyncPath": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"description": "Optional absolute path to the rsync binary on the remote server. If none is specified, the --rsync-path option is not used."
},
"filesToTransfer": {
"type": "string",
"description": "A comma separated list of relative paths, including the simple wildcard '*', to copy to the remote server. The paths are relative from the File Management area."
},
"transferFrequency":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/crontab/crontab.json",
"type": "object",
"required": ["minute", "hour", "dayOfMonth", "month", "dayOfWeek"],
"properties": {
"minute": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 59,
"description": "Minute for cron task. Integer 0-59 or a valid crontab element string. For repeating the task in specific interval, give comma separated minutes. e.g {0,15,30,45}."
},
"hour": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 23,
"description": "Hour for cron task. Integer 0-23 or a valid crontab element string."
},
"dayOfMonth": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 31,
"description": "Day of month for cron task. Integer 1-31 or a valid crontab element string."
},
"month": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 12,
"description": "Month for cron task. Integer 1-12 or a valid crontab element string."
},
"dayOfWeek": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 6,
"description": "Day of week for cron task. Integer 0-6 where 0 is Sunday or a valid crontab element string."
}
}
}
,
"UUID": {
"description": "Remote Server Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"taskName": "example task",
"taskDescription": "This is an example",
"hostname": "exportserver.mydomain.com",
"username": "exportuser",
"directory": "/home/exportuser/exportData/",
"rsyncPath": "/opt/customrsync/rsync",
"filesToTransfer": "export/*/KPI,backup/*",
"transferFrequency": {
"minute": 15,
"hour": 3,
"dayOfMonth": "*",
"month": "*",
"dayOfWeek": 1
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /admin/remoteservers
Insert a remote server for the OAM server where the request is sent.
Target server: NOAM or SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/remoteserver/remoteserver.json",
"type": "object",
"required": ["taskName", "hostname", "username", "transferFrequency"],
"notInsertable": ["UUID"],
"properties": {
"taskName": {
"type": "string",
"description": "Periodic Task name",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 1,
"maxLength": 40
},
"taskDescription": {
"type": "string",
"description": "Periodic Task description",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 0,
"maxLength": 255
},
"hostname": {
"type": "string",
"maxLength": 255,
"description": "Resolvable hostname or IPv4/IPv6 address of the remote server. Valid hostname characters are alphanumeric, minus sign, and period.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$"
},
"username": {
"type": "string",
"maxLength": 32,
"description": "Username to access the remote server. Valid characters are alphanumeric",
"pattern": "^[0-9a-zA-Z-]{1,32}$"
},
"directory": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_\\.\\-]*[\\/A-Za-z][A-Za-z0-9_\\.\\-]*)$",
"description": "Target absolute path on the export server where files are transferred. If none is provided, /home/{username} is used. Maximum length is a 4096-character string. Valid characters are alphanumeric (a-z, A-Z, and 0-9), dash, underscore, period, and forward slash."
},
"rsyncPath": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"description": "Optional absolute path to the rsync binary on the remote server. If none is specified, the --rsync-path option is not used."
},
"filesToTransfer": {
"type": "string",
"description": "A comma separated list of relative paths, including the simple wildcard '*', to copy to the remote server. The paths are relative from the File Management area."
},
"transferFrequency":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/crontab/crontab.json",
"type": "object",
"required": ["minute", "hour", "dayOfMonth", "month", "dayOfWeek"],
"properties": {
"minute": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 59,
"description": "Minute for cron task. Integer 0-59 or a valid crontab element string. For repeating the task in specific interval, give comma separated minutes. e.g {0,15,30,45}."
},
"hour": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 23,
"description": "Hour for cron task. Integer 0-23 or a valid crontab element string."
},
"dayOfMonth": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 31,
"description": "Day of month for cron task. Integer 1-31 or a valid crontab element string."
},
"month": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 12,
"description": "Month for cron task. Integer 1-12 or a valid crontab element string."
},
"dayOfWeek": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 6,
"description": "Day of week for cron task. Integer 0-6 where 0 is Sunday or a valid crontab element string."
}
}
}
,
"UUID": {
"description": "Remote Server Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
}
}
}
Example
{
"taskName": "example task",
"taskDescription": "This is an example",
"hostname": "exportserver.mydomain.com",
"username": "exportuser",
"directory": "/home/exportuser/exportData/",
"rsyncPath": "/opt/customrsync/rsync",
"filesToTransfer": "export/*/KPI,backup/*",
"transferFrequency": {
"minute": 15,
"hour": 3,
"dayOfMonth": "*",
"month": "*",
"dayOfWeek": 1
}
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/admin/remoteservers/{uuid}
get /admin/remoteservers/{uuid}
Retrieve the configuration data for a specific remote server given by the URI parameter UUID.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/items/remoteserverItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/remoteserver/remoteserver.json",
"type": "object",
"required": ["taskName", "hostname", "username", "transferFrequency"],
"notInsertable": ["UUID"],
"properties": {
"taskName": {
"type": "string",
"description": "Periodic Task name",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 1,
"maxLength": 40
},
"taskDescription": {
"type": "string",
"description": "Periodic Task description",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 0,
"maxLength": 255
},
"hostname": {
"type": "string",
"maxLength": 255,
"description": "Resolvable hostname or IPv4/IPv6 address of the remote server. Valid hostname characters are alphanumeric, minus sign, and period.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$"
},
"username": {
"type": "string",
"maxLength": 32,
"description": "Username to access the remote server. Valid characters are alphanumeric",
"pattern": "^[0-9a-zA-Z-]{1,32}$"
},
"directory": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_\\.\\-]*[\\/A-Za-z][A-Za-z0-9_\\.\\-]*)$",
"description": "Target absolute path on the export server where files are transferred. If none is provided, /home/{username} is used. Maximum length is a 4096-character string. Valid characters are alphanumeric (a-z, A-Z, and 0-9), dash, underscore, period, and forward slash."
},
"rsyncPath": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"description": "Optional absolute path to the rsync binary on the remote server. If none is specified, the --rsync-path option is not used."
},
"filesToTransfer": {
"type": "string",
"description": "A comma separated list of relative paths, including the simple wildcard '*', to copy to the remote server. The paths are relative from the File Management area."
},
"transferFrequency":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/crontab/crontab.json",
"type": "object",
"required": ["minute", "hour", "dayOfMonth", "month", "dayOfWeek"],
"properties": {
"minute": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 59,
"description": "Minute for cron task. Integer 0-59 or a valid crontab element string. For repeating the task in specific interval, give comma separated minutes. e.g {0,15,30,45}."
},
"hour": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 23,
"description": "Hour for cron task. Integer 0-23 or a valid crontab element string."
},
"dayOfMonth": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 31,
"description": "Day of month for cron task. Integer 1-31 or a valid crontab element string."
},
"month": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 12,
"description": "Month for cron task. Integer 1-12 or a valid crontab element string."
},
"dayOfWeek": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 6,
"description": "Day of week for cron task. Integer 0-6 where 0 is Sunday or a valid crontab element string."
}
}
}
,
"UUID": {
"description": "Remote Server Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"taskName": "example task",
"taskDescription": "This is an example",
"hostname": "exportserver.mydomain.com",
"username": "exportuser",
"directory": "/home/exportuser/exportData/",
"rsyncPath": "/opt/customrsync/rsync",
"filesToTransfer": "export/*/KPI,backup/*",
"transferFrequency": {
"minute": 15,
"hour": 3,
"dayOfMonth": "*",
"month": "*",
"dayOfWeek": 1
}
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/remoteservers/{uuid}
Modify the configuration data for a specific remote server given by the URI parameter UUID.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/remoteserver/remoteserver.json",
"type": "object",
"required": ["taskName", "hostname", "username", "transferFrequency"],
"notInsertable": ["UUID"],
"properties": {
"taskName": {
"type": "string",
"description": "Periodic Task name",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 1,
"maxLength": 40
},
"taskDescription": {
"type": "string",
"description": "Periodic Task description",
"pattern": "^([a-zA-Z]|[a-zA-Z][a-zA-Z0-9- ]*[a-zA-Z0-9])$",
"minLength": 0,
"maxLength": 255
},
"hostname": {
"type": "string",
"maxLength": 255,
"description": "Resolvable hostname or IPv4/IPv6 address of the remote server. Valid hostname characters are alphanumeric, minus sign, and period.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9\\-]*[a-zA-Z0-9])\\.)*([A-Za-z0-9]|[A-Za-z0-9][A-Za-z0-9\\-]*[A-Za-z0-9])$"
},
"username": {
"type": "string",
"maxLength": 32,
"description": "Username to access the remote server. Valid characters are alphanumeric",
"pattern": "^[0-9a-zA-Z-]{1,32}$"
},
"directory": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_\\.\\-]*[\\/A-Za-z][A-Za-z0-9_\\.\\-]*)$",
"description": "Target absolute path on the export server where files are transferred. If none is provided, /home/{username} is used. Maximum length is a 4096-character string. Valid characters are alphanumeric (a-z, A-Z, and 0-9), dash, underscore, period, and forward slash."
},
"rsyncPath": {
"type": "string",
"pattern": "^([(\\/)A-Za-z0-9_]*[\\/A-Za-z][A-Za-z0-9_]*)$",
"description": "Optional absolute path to the rsync binary on the remote server. If none is specified, the --rsync-path option is not used."
},
"filesToTransfer": {
"type": "string",
"description": "A comma separated list of relative paths, including the simple wildcard '*', to copy to the remote server. The paths are relative from the File Management area."
},
"transferFrequency":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/crontab/crontab.json",
"type": "object",
"required": ["minute", "hour", "dayOfMonth", "month", "dayOfWeek"],
"properties": {
"minute": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 59,
"description": "Minute for cron task. Integer 0-59 or a valid crontab element string. For repeating the task in specific interval, give comma separated minutes. e.g {0,15,30,45}."
},
"hour": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 23,
"description": "Hour for cron task. Integer 0-23 or a valid crontab element string."
},
"dayOfMonth": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 31,
"description": "Day of month for cron task. Integer 1-31 or a valid crontab element string."
},
"month": {
"type": ["integer", "string"],
"minimum": 1,
"maximum": 12,
"description": "Month for cron task. Integer 1-12 or a valid crontab element string."
},
"dayOfWeek": {
"type": ["integer", "string"],
"minimum": 0,
"maximum": 6,
"description": "Day of week for cron task. Integer 0-6 where 0 is Sunday or a valid crontab element string."
}
}
}
,
"UUID": {
"description": "Remote Server Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
}
}
}
Example
{
"taskName": "example task",
"taskDescription": "This is an example",
"hostname": "exportserver.mydomain.com",
"username": "exportuser",
"directory": "/home/exportuser/exportData/",
"rsyncPath": "/opt/customrsync/rsync",
"filesToTransfer": "export/*/KPI,backup/*",
"transferFrequency": {
"minute": 15,
"hour": 3,
"dayOfMonth": "*",
"month": "*",
"dayOfWeek": 1
}
}
delete /admin/remoteservers/{uuid}
Remove a specific remote server given by the URI parameter UUID.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
/admin/remoteservers/{uuid}/keyexchange
put /admin/remoteservers/{uuid}/keyexchange
Perform an SSH key exchange between the OAM server using the given password and the specified data export server(s).
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/remoteserver/remoteserverkeyexchange.json",
"type" : "object",
"required": ["password"],
"properties" : {
"password": {
"type": "string",
"description": "Password to perform the keyexchange, using the username from the remote server configuration"
}
}
}
Example
{
"password": "password1234"
}
/admin/remoteservers/{uuid}/transfer
get /admin/remoteservers/{uuid}/transfer
Initiates a transfer of any data files in the export and backup (if enabled) directories to the export server.
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
HTTP status code 202
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/taskItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/task/task.json",
"type" :"object",
"required": [
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Task identifier"
},
"hostname": {
"type": "string",
"description": "Server running task"
},
"name": {
"type": "string",
"description": "Task Name"
},
"status": {
"type": "string",
"description": "Admin Status",
"enum": [ "Running", "Stopped", "Paused", "Completed", "Exception" ]
},
"startTime": {
"description": "The task start time",
"type": "string",
"example":"2015-08-12T14:46:13-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"updateTime": {
"description": "The task status last update time",
"type": "string",
"example":"2015-08-12T14:47:43-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"progress": {
"description": "The task progress",
"type": "integer",
"example":"100",
"minimum" : 0,
"maximum" : 100
},
"details": {
"description": "Task Details",
"type": "string",
"example": "Lots of interesting details..."
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "ruby-noa:0",
"server": "ruby-noa",
"name": "joe",
"status": "completed",
"startTime": "2015-09-28T13:33:05-04:00",
"updateTime": "2015-09-28T13:34:11-04:00",
"progress": 100,
"details": "Lots of task details..."
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/admin/remoteservers/{uuid}/test
get /admin/remoteservers/{uuid}/test
Perform an immediate test transfer to the specified data export.
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
HTTP status code 202
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/taskItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/task/task.json",
"type" :"object",
"required": [
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Task identifier"
},
"hostname": {
"type": "string",
"description": "Server running task"
},
"name": {
"type": "string",
"description": "Task Name"
},
"status": {
"type": "string",
"description": "Admin Status",
"enum": [ "Running", "Stopped", "Paused", "Completed", "Exception" ]
},
"startTime": {
"description": "The task start time",
"type": "string",
"example":"2015-08-12T14:46:13-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"updateTime": {
"description": "The task status last update time",
"type": "string",
"example":"2015-08-12T14:47:43-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"progress": {
"description": "The task progress",
"type": "integer",
"example":"100",
"minimum" : 0,
"maximum" : 100
},
"details": {
"description": "Task Details",
"type": "string",
"example": "Lots of interesting details..."
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "ruby-noa:0",
"server": "ruby-noa",
"name": "joe",
"status": "completed",
"startTime": "2015-09-28T13:33:05-04:00",
"updateTime": "2015-09-28T13:34:11-04:00",
"progress": 100,
"details": "Lots of task details..."
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/admin/remoteservers/{uuid}/sshkeys
get /admin/remoteservers/{uuid}/sshkeys
Retrieve the ssh public RSA keys for OAM servers.
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/sshkeyCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/remoteserver/sshkey.json",
"type" : "object",
"required": ["keytype", "key", "comment"],
"properties" : {
"keytype": {
"description": "Type of SSH Public Key",
"enum": [ "ssh-dss", "ssh-dsa", "ssh-rsa", "ssh-ecdsa"]
},
"key": {
"type": "string",
"description": "SSH Public Key"
},
"comment": {
"type": "string",
"description": "Comment field. By default the username and hostname the key is associated with"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"keytype": "ssh-dss",
"key": "AAAAB3NzaC1kc3MAAACBAOKEfVUMVS/uki2ozeU7KDOWx2u+PKyf+oepLIb6Apytr0Cvm42QxF+o8MHuCOBhXVqrZFQ/vtV/ayhlrcC6nEJXto8TbxorWPGIph7VWHCd3lIEbW6f2K0y+pfAi2OsRFyNpaEn8AhbE23p6vr+DkIBFldVK3ons0VgiSnhbS3JAAAAFQDX0eFT/upF367RfxfDUX4kyzJsawAAAIEAkhD4pFqE3SPU/YbTw+hGKvUeVTlQRtrQjTaHu6yNYJRnWp9y1ZjOzVAFHbvURmiHSqgGbGqOqtTwwxjF1zHLVWRBOIK9fY1U9lpJsfOfiLXY7kfu+wPfBfP/z0/sSRrmfaROA0wTPN5uDzoP4YuJRy3iWMmUrkLac1sZmQt4+FkAAACBAIB7K3wPc9s8IAlmMY0HoTrevBfYyqO6rkk27XNeqqMJd1S6al/WMoMlec3YX5Ozje5Ep0PZqcMlNAIEuJGK/AOeoDZBOqeq3j9EnoVmN3gIo2MUnMeJCdel3BsbtW81X2pvhrYZ0LE0QMBMug0PcK7kuDTjVxzZTGWB//meOdFJ",
"comment": "username@server-noa"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Admin: Security Certificates
The Security Certificate resource allows a client to configure X.509 certificates and private keys, and to retrieve X.509 certificates.
A private key can be configured with its associated certificate, although only certain certificate types are configured with private keys. Private keys can be configured with a certificate only when first added to the configuration, and private keys cannot be subsequently accessed by the client. Private keys cannot be updated, and are never included in GET response data. If the certificate information for an existing certificate is updated, the updated information is stored with the existing private key. If a private key must be changed, the entire certificate must be deleted and a new one added with the correct private key.
Each certificate (and its associated private key, if configured) is identified by the certificate's Common Name, which is a string embedded within the encrypted certificate information. When a client performs a GET, PUT, or DELETE of a single certificate, the client must first extract the Common Name and use it in the URI sent to the DSR.
In this release of the DSR software, only certificates of type CA or TLS (both used for secure Diameter signaling Connections (/diameter/connections)) can be inserted via MMI into the configuration. Certificates of other types, configured via other means (e.g., the GUI), are returned in a collection GET response so a client has access to all configured certificiates. But these other types cannot currently be added to the DSR configuration using the machine-to-machine interface.
Certificate configuration is created, edited, and retrieved at the NOAM, but certificates can also be retrieved from any active SOAM server. No certificate changes can be made at any SOAM.
/admin/securitycertificates
get /admin/securitycertificates
Returns all configured Security Certificates, regardless of type, but never includes private keys or passphrases.
Target server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/securitycertificateCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/securitycertificate/securitycertificate.json",
"properties": {
"name": {
"description": "The name for this certificate. The DSR assigns the name string; it is never assigned by the client. For most certificate types, this string is the Common Name taken directly from the contents of the certificate itself. The exception is for certificates of type SSOLocal, where the name string is the Single Sign-On zone name. There is no definable pattern that certificate name strings must follow.",
"maxLength": 64,
"readOnly": true,
"type": "string"
},
"passphrase": {
"description": "If a privateKey is provided, it may be encrypted by the client using a passphrase. In this case, the passphrase must be provided so the DSR can decrypt the privateKey before using it. The passphrase should be omitted if the privateKey is not encrypted. The passphrase is not stored by the DSR. When certificate information is retrieved from the DSR via any GET operation, the passphrase attribute is never present in the response. There is no definable pattern that passphrase strings must follow.",
"maxLength": 15,
"type": "string"
},
"privateKey": {
"description": "The private key used in association with the public key stored in the x509Certificate. Private keys are only used with certain certificateTypes, typically including TLS and the HTTPS types. Once the privateKey is first inserted into the DSR configuration, it cannot be retrieved nor updated. When certificate information is retrieved from the DSR via any GET operation, the privateKey attribute is never present in the response. There is no definable pattern that privateKey strings must follow. Max supported length of the X509 Certificate private key is 8096 characters.",
"maxLength": 8096,
"type": "string"
},
"certificateType": {
"description": "Identifies the security certificate type. The type is based on the certificate's use within the DSR. Ca and Tls certificates are used when establishing a secure Diameter Connection (/diameter/connections) between the DSR and a Peer Node. The Ldap certificate is used when establishing a secure channel between the DSR and an external LDAP server. The three HTTPS types apply to secure HTTP links between clients and DSR OAM servers. An HttpsWildcard certificate spans the entire DSR network, meaning all OAM servers within the DSR network use the same HTTPS certificate. An HttpsServerGroup certficate is scoped to the OAM servers within an NOAM or SOAM Server Group (/topo/servergroups), while an HttpsServer certificate applies to just a single OAM server (/topo/servers). Finally, the SsoLocal certificate is used when a Single Sign-On zone for GUI access is configured for the DSR. For this release of the DSR sofrtware, the only certificate types that can be inserted by the client using the /admin/securitycertificates API are Ca and Tls. Certificates of other types may be present in the DSR configuration if they were inserted by other means (e.g., the GUI), and those other types will be present in the response to a client's request to GET all certificate data. Max supported length of the X509 Certificate is 8096 characters.",
"enum": [
"Ca",
"Ldap",
"HttpsServer",
"HttpsServerGroup",
"HttpsWildcard",
"SsoLocal",
"SsoRemote",
"Tls"
],
"readOnly": true,
"type": "string"
},
"x509Certificate": {
"description": "The Privacy Enhanced Mail (PEM)-encoded X.509 security certificate.",
"maxLength": 8096,
"type": "string"
}
},
"required": [
"x509Certificate"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "SERVER",
"certificateType": "TLS",
"x509Certificate": "-----BEGIN CERTIFICATE-----\nMIICqzCCAhQCAQEwDQYJKoZIhvcNAQEEBQAwgZ4xCzAJBgNVBAYTAlVTMRcwFQYD\nVQQIDA5Ob3J0aCBDYXJvbGluYTEUMBIGA1UEBwwLTW9ycmlzdmlsbGUxDzANBgNV\nBAoMBk9yYWNsZTEQMA4GA1UECwwHQ0FfVGVzdDETMBEGA1UEAwwKU3RraXR0c19D\nQTEoMCYGCSqGSIb3DQEJARYZbWF0dGhldy5maXNoZXJAb3JhY2xlLmNvbTAeFw0x\nNjExMDExNzE4MDlaFw0xNzExMDExNzE4MDlaMIGcMQswCQYDVQQGEwJVUzEXMBUG\nA1UECAwOTm9ydGggQ2Fyb2xpbmExFDASBgNVBAcMC01vcnJpc3ZpbGxlMQ8wDQYD\nVQQKDAZPcmFjbGUxETAPBgNVBAsMCFRlc3RUZXN0MRAwDgYDVQQDDAdTdGtpdHRz\nMSgwJgYJKoZIhvcNAQkBFhltYXR0aGV3LmZpc2hlckBvcmFjbGUuY29tMIGfMA0G\nCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDnEgS08aLnFra8tozs61tYAd09dgRWHSet\nGR/qrmUbNW5b2Xpqvn+CsTxipQIxp0PjeN0X3PuMCQDGudDfkGLXke/cCcyZMZ2N\nSdvMyxVOx8AR2+drkPpe8K/6jfhCorsfD1TzlW0rigTfgIvO8BhD3pnBZF+41o8C\nF0/FrLCy7QIDAQABMA0GCSqGSIb3DQEBBAUAA4GBAAeOdSl85XPoeUFLyZvwfyDD\noydRy82Kw/gmoTR+O7PCFZlR3vwNv/cR9eYnGcn981SSpdwnKhCjjW7vpYORtnos\nLOC2f08Xa5spqT/d/4nEbxyfXyM6SU5wagsuh8wuqrQMUd/P4+qL5ruRhAzT4oNc\n2I22+7hxvXZXXg/EmsT4\n-----END CERTIFICATE-----"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /admin/securitycertificates
Adds a new Security Certificate to the DSR configuration. In this release of the DSR software, only certificates for secure Diameter signaling Connections (/diameter/connections) - type CA or TLS - can be added via the POST operation.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/securitycertificate/securitycertificate.json",
"properties": {
"name": {
"description": "The name for this certificate. The DSR assigns the name string; it is never assigned by the client. For most certificate types, this string is the Common Name taken directly from the contents of the certificate itself. The exception is for certificates of type SSOLocal, where the name string is the Single Sign-On zone name. There is no definable pattern that certificate name strings must follow.",
"maxLength": 64,
"readOnly": true,
"type": "string"
},
"passphrase": {
"description": "If a privateKey is provided, it may be encrypted by the client using a passphrase. In this case, the passphrase must be provided so the DSR can decrypt the privateKey before using it. The passphrase should be omitted if the privateKey is not encrypted. The passphrase is not stored by the DSR. When certificate information is retrieved from the DSR via any GET operation, the passphrase attribute is never present in the response. There is no definable pattern that passphrase strings must follow.",
"maxLength": 15,
"type": "string"
},
"privateKey": {
"description": "The private key used in association with the public key stored in the x509Certificate. Private keys are only used with certain certificateTypes, typically including TLS and the HTTPS types. Once the privateKey is first inserted into the DSR configuration, it cannot be retrieved nor updated. When certificate information is retrieved from the DSR via any GET operation, the privateKey attribute is never present in the response. There is no definable pattern that privateKey strings must follow. Max supported length of the X509 Certificate private key is 8096 characters.",
"maxLength": 8096,
"type": "string"
},
"certificateType": {
"description": "Identifies the security certificate type. The type is based on the certificate's use within the DSR. Ca and Tls certificates are used when establishing a secure Diameter Connection (/diameter/connections) between the DSR and a Peer Node. The Ldap certificate is used when establishing a secure channel between the DSR and an external LDAP server. The three HTTPS types apply to secure HTTP links between clients and DSR OAM servers. An HttpsWildcard certificate spans the entire DSR network, meaning all OAM servers within the DSR network use the same HTTPS certificate. An HttpsServerGroup certficate is scoped to the OAM servers within an NOAM or SOAM Server Group (/topo/servergroups), while an HttpsServer certificate applies to just a single OAM server (/topo/servers). Finally, the SsoLocal certificate is used when a Single Sign-On zone for GUI access is configured for the DSR. For this release of the DSR sofrtware, the only certificate types that can be inserted by the client using the /admin/securitycertificates API are Ca and Tls. Certificates of other types may be present in the DSR configuration if they were inserted by other means (e.g., the GUI), and those other types will be present in the response to a client's request to GET all certificate data. Max supported length of the X509 Certificate is 8096 characters.",
"enum": [
"Ca",
"Ldap",
"HttpsServer",
"HttpsServerGroup",
"HttpsWildcard",
"SsoLocal",
"SsoRemote",
"Tls"
],
"readOnly": true,
"type": "string"
},
"x509Certificate": {
"description": "The Privacy Enhanced Mail (PEM)-encoded X.509 security certificate.",
"maxLength": 8096,
"type": "string"
}
},
"required": [
"x509Certificate"
],
"type": "object"
}
Example
{
"name": "SERVER",
"certificateType": "TLS",
"x509Certificate": "-----BEGIN CERTIFICATE-----\nMIICqzCCAhQCAQEwDQYJKoZIhvcNAQEEBQAwgZ4xCzAJBgNVBAYTAlVTMRcwFQYD\nVQQIDA5Ob3J0aCBDYXJvbGluYTEUMBIGA1UEBwwLTW9ycmlzdmlsbGUxDzANBgNV\nBAoMBk9yYWNsZTEQMA4GA1UECwwHQ0FfVGVzdDETMBEGA1UEAwwKU3RraXR0c19D\nQTEoMCYGCSqGSIb3DQEJARYZbWF0dGhldy5maXNoZXJAb3JhY2xlLmNvbTAeFw0x\nNjExMDExNzE4MDlaFw0xNzExMDExNzE4MDlaMIGcMQswCQYDVQQGEwJVUzEXMBUG\nA1UECAwOTm9ydGggQ2Fyb2xpbmExFDASBgNVBAcMC01vcnJpc3ZpbGxlMQ8wDQYD\nVQQKDAZPcmFjbGUxETAPBgNVBAsMCFRlc3RUZXN0MRAwDgYDVQQDDAdTdGtpdHRz\nMSgwJgYJKoZIhvcNAQkBFhltYXR0aGV3LmZpc2hlckBvcmFjbGUuY29tMIGfMA0G\nCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDnEgS08aLnFra8tozs61tYAd09dgRWHSet\nGR/qrmUbNW5b2Xpqvn+CsTxipQIxp0PjeN0X3PuMCQDGudDfkGLXke/cCcyZMZ2N\nSdvMyxVOx8AR2+drkPpe8K/6jfhCorsfD1TzlW0rigTfgIvO8BhD3pnBZF+41o8C\nF0/FrLCy7QIDAQABMA0GCSqGSIb3DQEBBAUAA4GBAAeOdSl85XPoeUFLyZvwfyDD\noydRy82Kw/gmoTR+O7PCFZlR3vwNv/cR9eYnGcn981SSpdwnKhCjjW7vpYORtnos\nLOC2f08Xa5spqT/d/4nEbxyfXyM6SU5wagsuh8wuqrQMUd/P4+qL5ruRhAzT4oNc\n2I22+7hxvXZXXg/EmsT4\n-----END CERTIFICATE-----"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/admin/securitycertificates/{name}
get /admin/securitycertificates/{name}
Returns the specified Security Certificate. The certificate is identified by its Common Name. If the named Security Certificate does not exist in the OAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/items/securitycertificateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/securitycertificate/securitycertificate.json",
"properties": {
"name": {
"description": "The name for this certificate. The DSR assigns the name string; it is never assigned by the client. For most certificate types, this string is the Common Name taken directly from the contents of the certificate itself. The exception is for certificates of type SSOLocal, where the name string is the Single Sign-On zone name. There is no definable pattern that certificate name strings must follow.",
"maxLength": 64,
"readOnly": true,
"type": "string"
},
"passphrase": {
"description": "If a privateKey is provided, it may be encrypted by the client using a passphrase. In this case, the passphrase must be provided so the DSR can decrypt the privateKey before using it. The passphrase should be omitted if the privateKey is not encrypted. The passphrase is not stored by the DSR. When certificate information is retrieved from the DSR via any GET operation, the passphrase attribute is never present in the response. There is no definable pattern that passphrase strings must follow.",
"maxLength": 15,
"type": "string"
},
"privateKey": {
"description": "The private key used in association with the public key stored in the x509Certificate. Private keys are only used with certain certificateTypes, typically including TLS and the HTTPS types. Once the privateKey is first inserted into the DSR configuration, it cannot be retrieved nor updated. When certificate information is retrieved from the DSR via any GET operation, the privateKey attribute is never present in the response. There is no definable pattern that privateKey strings must follow. Max supported length of the X509 Certificate private key is 8096 characters.",
"maxLength": 8096,
"type": "string"
},
"certificateType": {
"description": "Identifies the security certificate type. The type is based on the certificate's use within the DSR. Ca and Tls certificates are used when establishing a secure Diameter Connection (/diameter/connections) between the DSR and a Peer Node. The Ldap certificate is used when establishing a secure channel between the DSR and an external LDAP server. The three HTTPS types apply to secure HTTP links between clients and DSR OAM servers. An HttpsWildcard certificate spans the entire DSR network, meaning all OAM servers within the DSR network use the same HTTPS certificate. An HttpsServerGroup certficate is scoped to the OAM servers within an NOAM or SOAM Server Group (/topo/servergroups), while an HttpsServer certificate applies to just a single OAM server (/topo/servers). Finally, the SsoLocal certificate is used when a Single Sign-On zone for GUI access is configured for the DSR. For this release of the DSR sofrtware, the only certificate types that can be inserted by the client using the /admin/securitycertificates API are Ca and Tls. Certificates of other types may be present in the DSR configuration if they were inserted by other means (e.g., the GUI), and those other types will be present in the response to a client's request to GET all certificate data. Max supported length of the X509 Certificate is 8096 characters.",
"enum": [
"Ca",
"Ldap",
"HttpsServer",
"HttpsServerGroup",
"HttpsWildcard",
"SsoLocal",
"SsoRemote",
"Tls"
],
"readOnly": true,
"type": "string"
},
"x509Certificate": {
"description": "The Privacy Enhanced Mail (PEM)-encoded X.509 security certificate.",
"maxLength": 8096,
"type": "string"
}
},
"required": [
"x509Certificate"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "SERVER",
"certificateType": "TLS",
"x509Certificate": "-----BEGIN CERTIFICATE-----\nMIICqzCCAhQCAQEwDQYJKoZIhvcNAQEEBQAwgZ4xCzAJBgNVBAYTAlVTMRcwFQYD\nVQQIDA5Ob3J0aCBDYXJvbGluYTEUMBIGA1UEBwwLTW9ycmlzdmlsbGUxDzANBgNV\nBAoMBk9yYWNsZTEQMA4GA1UECwwHQ0FfVGVzdDETMBEGA1UEAwwKU3RraXR0c19D\nQTEoMCYGCSqGSIb3DQEJARYZbWF0dGhldy5maXNoZXJAb3JhY2xlLmNvbTAeFw0x\nNjExMDExNzE4MDlaFw0xNzExMDExNzE4MDlaMIGcMQswCQYDVQQGEwJVUzEXMBUG\nA1UECAwOTm9ydGggQ2Fyb2xpbmExFDASBgNVBAcMC01vcnJpc3ZpbGxlMQ8wDQYD\nVQQKDAZPcmFjbGUxETAPBgNVBAsMCFRlc3RUZXN0MRAwDgYDVQQDDAdTdGtpdHRz\nMSgwJgYJKoZIhvcNAQkBFhltYXR0aGV3LmZpc2hlckBvcmFjbGUuY29tMIGfMA0G\nCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDnEgS08aLnFra8tozs61tYAd09dgRWHSet\nGR/qrmUbNW5b2Xpqvn+CsTxipQIxp0PjeN0X3PuMCQDGudDfkGLXke/cCcyZMZ2N\nSdvMyxVOx8AR2+drkPpe8K/6jfhCorsfD1TzlW0rigTfgIvO8BhD3pnBZF+41o8C\nF0/FrLCy7QIDAQABMA0GCSqGSIb3DQEBBAUAA4GBAAeOdSl85XPoeUFLyZvwfyDD\noydRy82Kw/gmoTR+O7PCFZlR3vwNv/cR9eYnGcn981SSpdwnKhCjjW7vpYORtnos\nLOC2f08Xa5spqT/d/4nEbxyfXyM6SU5wagsuh8wuqrQMUd/P4+qL5ruRhAzT4oNc\n2I22+7hxvXZXXg/EmsT4\n-----END CERTIFICATE-----"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/securitycertificates/{name}
Updates the specified Security Certificate. The certificate is identified by its Common Name. Only the X.509 certificate information itself can be updated - private keys and passphrases cannot be updated for an existing certificate. If a private key or passphrase must be updated, the certificate should be deleted, then inserted back into the configuration with the desired private key and/or passphrase.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/securitycertificate/securitycertificate.json",
"properties": {
"name": {
"description": "The name for this certificate. The DSR assigns the name string; it is never assigned by the client. For most certificate types, this string is the Common Name taken directly from the contents of the certificate itself. The exception is for certificates of type SSOLocal, where the name string is the Single Sign-On zone name. There is no definable pattern that certificate name strings must follow.",
"maxLength": 64,
"readOnly": true,
"type": "string"
},
"passphrase": {
"description": "If a privateKey is provided, it may be encrypted by the client using a passphrase. In this case, the passphrase must be provided so the DSR can decrypt the privateKey before using it. The passphrase should be omitted if the privateKey is not encrypted. The passphrase is not stored by the DSR. When certificate information is retrieved from the DSR via any GET operation, the passphrase attribute is never present in the response. There is no definable pattern that passphrase strings must follow.",
"maxLength": 15,
"type": "string"
},
"privateKey": {
"description": "The private key used in association with the public key stored in the x509Certificate. Private keys are only used with certain certificateTypes, typically including TLS and the HTTPS types. Once the privateKey is first inserted into the DSR configuration, it cannot be retrieved nor updated. When certificate information is retrieved from the DSR via any GET operation, the privateKey attribute is never present in the response. There is no definable pattern that privateKey strings must follow. Max supported length of the X509 Certificate private key is 8096 characters.",
"maxLength": 8096,
"type": "string"
},
"certificateType": {
"description": "Identifies the security certificate type. The type is based on the certificate's use within the DSR. Ca and Tls certificates are used when establishing a secure Diameter Connection (/diameter/connections) between the DSR and a Peer Node. The Ldap certificate is used when establishing a secure channel between the DSR and an external LDAP server. The three HTTPS types apply to secure HTTP links between clients and DSR OAM servers. An HttpsWildcard certificate spans the entire DSR network, meaning all OAM servers within the DSR network use the same HTTPS certificate. An HttpsServerGroup certficate is scoped to the OAM servers within an NOAM or SOAM Server Group (/topo/servergroups), while an HttpsServer certificate applies to just a single OAM server (/topo/servers). Finally, the SsoLocal certificate is used when a Single Sign-On zone for GUI access is configured for the DSR. For this release of the DSR sofrtware, the only certificate types that can be inserted by the client using the /admin/securitycertificates API are Ca and Tls. Certificates of other types may be present in the DSR configuration if they were inserted by other means (e.g., the GUI), and those other types will be present in the response to a client's request to GET all certificate data. Max supported length of the X509 Certificate is 8096 characters.",
"enum": [
"Ca",
"Ldap",
"HttpsServer",
"HttpsServerGroup",
"HttpsWildcard",
"SsoLocal",
"SsoRemote",
"Tls"
],
"readOnly": true,
"type": "string"
},
"x509Certificate": {
"description": "The Privacy Enhanced Mail (PEM)-encoded X.509 security certificate.",
"maxLength": 8096,
"type": "string"
}
},
"required": [
"x509Certificate"
],
"type": "object"
}
Example
{
"name": "SERVER",
"certificateType": "TLS",
"x509Certificate": "-----BEGIN CERTIFICATE-----\nMIICqzCCAhQCAQEwDQYJKoZIhvcNAQEEBQAwgZ4xCzAJBgNVBAYTAlVTMRcwFQYD\nVQQIDA5Ob3J0aCBDYXJvbGluYTEUMBIGA1UEBwwLTW9ycmlzdmlsbGUxDzANBgNV\nBAoMBk9yYWNsZTEQMA4GA1UECwwHQ0FfVGVzdDETMBEGA1UEAwwKU3RraXR0c19D\nQTEoMCYGCSqGSIb3DQEJARYZbWF0dGhldy5maXNoZXJAb3JhY2xlLmNvbTAeFw0x\nNjExMDExNzE4MDlaFw0xNzExMDExNzE4MDlaMIGcMQswCQYDVQQGEwJVUzEXMBUG\nA1UECAwOTm9ydGggQ2Fyb2xpbmExFDASBgNVBAcMC01vcnJpc3ZpbGxlMQ8wDQYD\nVQQKDAZPcmFjbGUxETAPBgNVBAsMCFRlc3RUZXN0MRAwDgYDVQQDDAdTdGtpdHRz\nMSgwJgYJKoZIhvcNAQkBFhltYXR0aGV3LmZpc2hlckBvcmFjbGUuY29tMIGfMA0G\nCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDnEgS08aLnFra8tozs61tYAd09dgRWHSet\nGR/qrmUbNW5b2Xpqvn+CsTxipQIxp0PjeN0X3PuMCQDGudDfkGLXke/cCcyZMZ2N\nSdvMyxVOx8AR2+drkPpe8K/6jfhCorsfD1TzlW0rigTfgIvO8BhD3pnBZF+41o8C\nF0/FrLCy7QIDAQABMA0GCSqGSIb3DQEBBAUAA4GBAAeOdSl85XPoeUFLyZvwfyDD\noydRy82Kw/gmoTR+O7PCFZlR3vwNv/cR9eYnGcn981SSpdwnKhCjjW7vpYORtnos\nLOC2f08Xa5spqT/d/4nEbxyfXyM6SU5wagsuh8wuqrQMUd/P4+qL5ruRhAzT4oNc\n2I22+7hxvXZXXg/EmsT4\n-----END CERTIFICATE-----"
}
delete /admin/securitycertificates/{name}
Deletes the specified Security Certificate from the DSR configuration. The certificate is identified by its Common Name.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Admin: Sessions
Get details of all elements of Sessions from Session Administration page.
Session elements can be deleted and retrieved at the NOAM, but can also be retrieved from any active SOAM server. No Session element changes can be made at any SOAM.
/admin/sessions
get /admin/sessions
Returns all elements of Sessions configured at the DSR.
Target Server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/sessionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/session/session.json",
"properties": {
"expirationTime": {
"description": "Shows the date and UTC time the session expires.",
"type": "string"
},
"group": {
"description": "Displays the Group to which the user belongs.",
"type": "string"
},
"loginTime": {
"description": "Shows the date and UTC time the session login time.",
"type": "string"
},
"remoteIP": {
"description": "Displays the IP address of the machine from which the user connected to the system.",
"type": "string"
},
"sessionID": {
"description": "Shows a system-assigned ID for the session.",
"type": "string"
},
"user": {
"description": "Displays the Username of the user logged in to the session.",
"type": "string"
}
},
"required": [
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"expirationTime": "Tue Mar 19 06:38:20 2019 EDT",
"group": "admin",
"loginTime": "Tue Mar 19 02:18:39 2019 EDT",
"remoteIP": "10.176.254.126",
"sessionID": "19",
"user": "guiadmin"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/admin/sessions/{sessionId}
get /admin/sessions/{sessionId}
Returns elements for the specified session. If the specified session does not exist in the NOAM's configuration, an error message is returned within the HTTP reponse.
Target Server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- sessionId: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/session/session.json",
"properties": {
"expirationTime": {
"description": "Shows the date and UTC time the session expires.",
"type": "string"
},
"group": {
"description": "Displays the Group to which the user belongs.",
"type": "string"
},
"loginTime": {
"description": "Shows the date and UTC time the session login time.",
"type": "string"
},
"remoteIP": {
"description": "Displays the IP address of the machine from which the user connected to the system.",
"type": "string"
},
"sessionID": {
"description": "Shows a system-assigned ID for the session.",
"type": "string"
},
"user": {
"description": "Displays the Username of the user logged in to the session.",
"type": "string"
}
},
"required": [
],
"type": "object"
}
Example
{
"data":
{
"expirationTime": "Tue Mar 19 06:38:20 2019 EDT",
"group": "admin",
"loginTime": "Tue Mar 19 02:18:39 2019 EDT",
"remoteIP": "10.176.254.126",
"sessionID": "19",
"user": "guiadmin"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /admin/sessions/{sessionId}
Deletes the specified session from the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- sessionId: required (string)
Admin: SFTP Users
The Secure File Transfer Protocol (SFTP) User resource allows a client to configure user accounts such that external servers can have SFTP access to Measurements, Events, Alarms, and Logs (MEAL) data stored on the DSR. SFTP User access to the DSR must be authenticated, and so each SFTP User configured must have either a Secure Shell (SSH) key or a password configured to it. Once properly configured, an authenticated user can retrieve MEAL data from the DSR using SFTP.
SFTP User configuration is created, edited, and retrieved at the NOAM, but can also be retrieved from any active SOAM server. No SFTP User configuration changes can be made at any SOAM.
/admin/sftpusers
get /admin/sftpusers
Returns all SFTP user accounts configured at the DSR.
Target Server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/sftpuserCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/sftpuser/sftpuser.json",
"properties": {
"comment": {
"description": "Comments about the SFTP user.",
"maxLength": 100,
"type": "string"
},
"permissions": {
"description": "Permissions associated with the SFTP User account. The SFTP user is only able to access export files matching their assigned permission level.",
"enum": [
"MeasurementsAlarmsEvents",
"SecurityLogs",
"MeasurementsAlarmsEventsSecurityLogs"
],
"type": "string"
},
"username": {
"description": "User name for the SFTP account. Valid character are between 5 and 32 lowercase alphanumeric charaters.",
"maxLength": 32,
"minLength": 5,
"pattern": "^[0-9a-z]{5,32}$",
"type": "string"
},
"sshKey": {
"description": "The SSH public key to use with this SFTP account. The key is typically generated using the ssh-keygen utility; the key starts with a type of 'ssh-rsa' or 'ssh-dsa', and is followed by the encoded key value. Anything following the key value (typically a comment string) is ignored.",
"maxLength": 8518,
"type": "string"
}
},
"required": [
"permissions",
"username"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"comments": "User is Admin",
"permissions": "MeasurementsAlarmsEvents",
"username": "sftpadministrator",
"sshKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAu1UzDEI96E9oVC0HHM/3DNHfa1dCjseXZsD9QeNLRTrQqZajPe1Q2JHI+q9txyzhCnAkySRLQTSxCjEaUREFQ6B6ecrZJcwoDBcfkVblHQU/ZifN652nFqIHotN/4TGcN1H7p7pagCp3Wmm3647xhRM6dhJ40/zn8h79/x4PxjvUmGpe6B8dEz+TMEYLM3pFq9cdK98nPcJssbHgOgW+IAljeyGkCoCKBjFhKOEdh2hiH5BMBy3BckvPNG01szNZYk3KFCW8tCGjlY1yYQfj+c83nriBqX3bB6CM8zw9yHYTEFJMRKvAbandlUEc+UfFXVOFiuh6tK6Zww7yBbjweNe6tTBqboWIcTaCxjlr1t3AZnHq8BSt2iF78TUs+hINSM9r7sYppEp9J/pLnTM+83ZhH87PIvVMG9BfZlmGewtrp4i1FWtEiNkxod0706/IlXlrn4WiiSlCNoH4TxcDziQzu+MazDSAPBbS6qX8BPPNpdjIGaxKvEVk0nitTnUOtoV6Fke7SLL5UNWKIQTnYgoUMFhg7ZiHgizD0T49iF+k83UiA/XA440xVXFOGonqzQ30lvDwOjTMCqBNjlv+7zXCVr7TRYDpFUIXpujmFEkYla8iJWICISQ3p7pEGGFHuB1iP+4Rb/f2vF2OK9EiFzvn/wu/5Dt3dVMz4oHcfsk= root@amber-noa"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /admin/sftpusers
Adds a new SFTP user account. The new SFTP username must be unique within the DSR configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/sftpuser/sftpuser.json",
"properties": {
"comment": {
"description": "Comments about the SFTP user.",
"maxLength": 100,
"type": "string"
},
"permissions": {
"description": "Permissions associated with the SFTP User account. The SFTP user is only able to access export files matching their assigned permission level.",
"enum": [
"MeasurementsAlarmsEvents",
"SecurityLogs",
"MeasurementsAlarmsEventsSecurityLogs"
],
"type": "string"
},
"username": {
"description": "User name for the SFTP account. Valid character are between 5 and 32 lowercase alphanumeric charaters.",
"maxLength": 32,
"minLength": 5,
"pattern": "^[0-9a-z]{5,32}$",
"type": "string"
},
"sshKey": {
"description": "The SSH public key to use with this SFTP account. The key is typically generated using the ssh-keygen utility; the key starts with a type of 'ssh-rsa' or 'ssh-dsa', and is followed by the encoded key value. Anything following the key value (typically a comment string) is ignored.",
"maxLength": 8518,
"type": "string"
}
},
"required": [
"permissions",
"username"
],
"type": "object"
}
Example
{
"comments": "User is Admin",
"permissions": "MeasurementsAlarmsEvents",
"username": "sftpadministrator",
"sshKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAu1UzDEI96E9oVC0HHM/3DNHfa1dCjseXZsD9QeNLRTrQqZajPe1Q2JHI+q9txyzhCnAkySRLQTSxCjEaUREFQ6B6ecrZJcwoDBcfkVblHQU/ZifN652nFqIHotN/4TGcN1H7p7pagCp3Wmm3647xhRM6dhJ40/zn8h79/x4PxjvUmGpe6B8dEz+TMEYLM3pFq9cdK98nPcJssbHgOgW+IAljeyGkCoCKBjFhKOEdh2hiH5BMBy3BckvPNG01szNZYk3KFCW8tCGjlY1yYQfj+c83nriBqX3bB6CM8zw9yHYTEFJMRKvAbandlUEc+UfFXVOFiuh6tK6Zww7yBbjweNe6tTBqboWIcTaCxjlr1t3AZnHq8BSt2iF78TUs+hINSM9r7sYppEp9J/pLnTM+83ZhH87PIvVMG9BfZlmGewtrp4i1FWtEiNkxod0706/IlXlrn4WiiSlCNoH4TxcDziQzu+MazDSAPBbS6qX8BPPNpdjIGaxKvEVk0nitTnUOtoV6Fke7SLL5UNWKIQTnYgoUMFhg7ZiHgizD0T49iF+k83UiA/XA440xVXFOGonqzQ30lvDwOjTMCqBNjlv+7zXCVr7TRYDpFUIXpujmFEkYla8iJWICISQ3p7pEGGFHuB1iP+4Rb/f2vF2OK9EiFzvn/wu/5Dt3dVMz4oHcfsk= root@amber-noa"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/admin/sftpusers/{username}
get /admin/sftpusers/{username}
Returns the configuration details for the specified SFTP user account. If the specified SFTP user does not exist in the NOAM's configuration, an error message is returned within the HTTP reponse.
Target Server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- username: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/sftpuser/sftpuser.json",
"properties": {
"comment": {
"description": "Comments about the SFTP user.",
"maxLength": 100,
"type": "string"
},
"permissions": {
"description": "Permissions associated with the SFTP User account. The SFTP user is only able to access export files matching their assigned permission level.",
"enum": [
"MeasurementsAlarmsEvents",
"SecurityLogs",
"MeasurementsAlarmsEventsSecurityLogs"
],
"type": "string"
},
"username": {
"description": "User name for the SFTP account. Valid character are between 5 and 32 lowercase alphanumeric charaters.",
"maxLength": 32,
"minLength": 5,
"pattern": "^[0-9a-z]{5,32}$",
"type": "string"
},
"sshKey": {
"description": "The SSH public key to use with this SFTP account. The key is typically generated using the ssh-keygen utility; the key starts with a type of 'ssh-rsa' or 'ssh-dsa', and is followed by the encoded key value. Anything following the key value (typically a comment string) is ignored.",
"maxLength": 8518,
"type": "string"
}
},
"required": [
"permissions",
"username"
],
"type": "object"
}
Example
{
"data":
{
"comments": "User is Admin",
"permissions": "MeasurementsAlarmsEvents",
"username": "sftpadministrator",
"sshKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAu1UzDEI96E9oVC0HHM/3DNHfa1dCjseXZsD9QeNLRTrQqZajPe1Q2JHI+q9txyzhCnAkySRLQTSxCjEaUREFQ6B6ecrZJcwoDBcfkVblHQU/ZifN652nFqIHotN/4TGcN1H7p7pagCp3Wmm3647xhRM6dhJ40/zn8h79/x4PxjvUmGpe6B8dEz+TMEYLM3pFq9cdK98nPcJssbHgOgW+IAljeyGkCoCKBjFhKOEdh2hiH5BMBy3BckvPNG01szNZYk3KFCW8tCGjlY1yYQfj+c83nriBqX3bB6CM8zw9yHYTEFJMRKvAbandlUEc+UfFXVOFiuh6tK6Zww7yBbjweNe6tTBqboWIcTaCxjlr1t3AZnHq8BSt2iF78TUs+hINSM9r7sYppEp9J/pLnTM+83ZhH87PIvVMG9BfZlmGewtrp4i1FWtEiNkxod0706/IlXlrn4WiiSlCNoH4TxcDziQzu+MazDSAPBbS6qX8BPPNpdjIGaxKvEVk0nitTnUOtoV6Fke7SLL5UNWKIQTnYgoUMFhg7ZiHgizD0T49iF+k83UiA/XA440xVXFOGonqzQ30lvDwOjTMCqBNjlv+7zXCVr7TRYDpFUIXpujmFEkYla8iJWICISQ3p7pEGGFHuB1iP+4Rb/f2vF2OK9EiFzvn/wu/5Dt3dVMz4oHcfsk= root@amber-noa"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/sftpusers/{username}
Updates the configuration for the SFTP user account. If the provided SFTP user data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- username: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/sftpuser/sftpuser.json",
"properties": {
"comment": {
"description": "Comments about the SFTP user.",
"maxLength": 100,
"type": "string"
},
"permissions": {
"description": "Permissions associated with the SFTP User account. The SFTP user is only able to access export files matching their assigned permission level.",
"enum": [
"MeasurementsAlarmsEvents",
"SecurityLogs",
"MeasurementsAlarmsEventsSecurityLogs"
],
"type": "string"
},
"username": {
"description": "User name for the SFTP account. Valid character are between 5 and 32 lowercase alphanumeric charaters.",
"maxLength": 32,
"minLength": 5,
"pattern": "^[0-9a-z]{5,32}$",
"type": "string"
},
"sshKey": {
"description": "The SSH public key to use with this SFTP account. The key is typically generated using the ssh-keygen utility; the key starts with a type of 'ssh-rsa' or 'ssh-dsa', and is followed by the encoded key value. Anything following the key value (typically a comment string) is ignored.",
"maxLength": 8518,
"type": "string"
}
},
"required": [
"permissions",
"username"
],
"type": "object"
}
Example
{
"comments": "User is Admin",
"permissions": "MeasurementsAlarmsEvents",
"username": "sftpadministrator",
"sshKey": "ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAgEAu1UzDEI96E9oVC0HHM/3DNHfa1dCjseXZsD9QeNLRTrQqZajPe1Q2JHI+q9txyzhCnAkySRLQTSxCjEaUREFQ6B6ecrZJcwoDBcfkVblHQU/ZifN652nFqIHotN/4TGcN1H7p7pagCp3Wmm3647xhRM6dhJ40/zn8h79/x4PxjvUmGpe6B8dEz+TMEYLM3pFq9cdK98nPcJssbHgOgW+IAljeyGkCoCKBjFhKOEdh2hiH5BMBy3BckvPNG01szNZYk3KFCW8tCGjlY1yYQfj+c83nriBqX3bB6CM8zw9yHYTEFJMRKvAbandlUEc+UfFXVOFiuh6tK6Zww7yBbjweNe6tTBqboWIcTaCxjlr1t3AZnHq8BSt2iF78TUs+hINSM9r7sYppEp9J/pLnTM+83ZhH87PIvVMG9BfZlmGewtrp4i1FWtEiNkxod0706/IlXlrn4WiiSlCNoH4TxcDziQzu+MazDSAPBbS6qX8BPPNpdjIGaxKvEVk0nitTnUOtoV6Fke7SLL5UNWKIQTnYgoUMFhg7ZiHgizD0T49iF+k83UiA/XA440xVXFOGonqzQ30lvDwOjTMCqBNjlv+7zXCVr7TRYDpFUIXpujmFEkYla8iJWICISQ3p7pEGGFHuB1iP+4Rb/f2vF2OK9EiFzvn/wu/5Dt3dVMz4oHcfsk= root@amber-noa"
}
delete /admin/sftpusers/{username}
Deletes the specified SFTP user from the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- username: required (string)
/admin/sftpusers/{username}/password
put /admin/sftpusers/{username}/password
Add a password or change an existing password for the specified SFTP User account.
Request
URI Parameters
- username: required (string)
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/sftpuser/sftpuserpassword.json",
"properties": {
"sftpUserPassword": {
"description": "Passwords for an SFTP User account must contain at least three of the following characters to be valid: numeric, lowercase letters, uppercase letters, or a special character (!@#$%^&*?~).",
"maxLength": 16,
"minLength": 8,
"type": "string"
}
},
"required": [
"sftpUserPassword"
],
"type": "object"
}
Example
{
"sftpUserPassword": "Password1234&"
}
Admin: SNMP Trapping
The Simple Network Management Protocol (SNMP) Trapping resource allows a client to configure external managers to receive unsolicited SNMP Traps (messages) from DSR servers. SNMP Trapping is configured in one of two modes: global (e.g., network-wide), or per-site. When configured as global, the same configuration is used by the active NOAM and each active SOAM within the DSR network. When configured as per-site, unique SNMP Trapping configuration can be created for each site, as well as for the NOAM.
Each SNMP Trapping configuration instance is identified by the OAM Server Group (/topo/servergroups) to which it corresponds. So in global mode, there is just one instance, and it is identified by the configured name of the NOAM Server Group. In per-site mode, there can be up to one instance per configured OAM Server Group.
SNMP Trapping configuration is created, edited, and retrieved at the NOAM, but can also be retrieved from any active SOAM server. No SNMP Trapping configuration changes can be made at any SOAM.
/admin/snmptrapping
get /admin/snmptrapping
Returns all SNMP Trapping configuration instances.
Target Server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/snmptrappingCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/snmptrapping/snmptrapping.json",
"properties": {
"configurationMode": {
"description": "When set to Global, the SNMP trap sending configuration instance applies to every OAM Server Group (/topo/servergroups) in the DSR network - the NOAM Server Group and each SOAM Server Group. When set to PerSite, each OAM Server Group can have its own unique SNMP trap sending configuration instance.",
"enum": [
"Global",
"PerSite"
],
"type": "string"
},
"managers": {
"description": "An SNMP Trapping configuration instance can specify up to five remote managers to receive SNMP traps. Each manager specified in this array receives SNMP traps sourced by the OAM Server Group(s) governed by this SNMP Trapping configuration instance.",
"items": {
"properties": {
"identifier": {
"description": "Identifies a remote manager to receive the SNMP traps, if the manager enabled via the enabled attribute. The value for the identifier consists of a network address optionally followed by the port for the remote manager. The network address can either be a valid IPv4 or IPv6 address, or a valid hostname. The port is optional, must be an integer between 1 and 65535, inclusive, and is specified by a colon (:) and port number following the network address. If no port number follows a network address, the standard SNMP trap port 162 is used by the DSR. IPv6 addresses must appear within square brackets if the port number is specified, like this: [IPv6_address]:port. Finally, hostnames are case-insensitive and cannot exceed 255 characters.",
"maxLength": 255,
"type": "string"
},
"enabled": {
"description": "When set to true, SNMP traps are autonomously sent to the external manager by the DSR. When set to false, traps are not sent to the external manager, but can be sent to any other manager that is in the enabled state.",
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"sendTrapsFromIndividualServers": {
"description": "When set to true, SNMP traps are sent from the individual servers within the scope of this SNMP Trapping configuration instance. When set to false, system-wide traps are sent from the active NOAM server and site-specific traps are sent from active SOAM servers.",
"type": "boolean"
},
"serverGroupName": {
"description": "The name of the OAM Server Group (/topo/servergroups) to which this SNMP Trapping instance applies. Must be either the NOAM Server Group name, or the name of one of the configured SOAM Server Groups.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"snmpVersionsEnabled": {
"description": "Indicates which version(s) of SNMP is/are enabled on the DSR. Supported SNMP versions are 2c and 3. When set to V2c or V2cAndV3, snmpV2cOptions must contain valid values. When set to V2cAndV3 or V3, snmpV3Options must contain valid values. Recommended value is V3.",
"enum": [
"V2c",
"V2cAndV3",
"V3"
],
"type": "string"
},
"snmpV2cOptions": {
"description": "The configuration options that must be set if SNMP version 2c is enabled for the DSR. Not required if SNMP version 2c is not enabled.",
"properties": {
"readOnlyCommunityName": {
"description": "The read-only community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readOnlyCommunityName attribute is never present in the response - it is effectively a write-only attribute..",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
},
"readWriteCommunityName": {
"description": "The read-write community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readWriteCommunityName attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
}
},
"type": "object"
},
"snmpV3Options": {
"description": "The configuration options that must be set if SNMP version 3 is enabled for the DSR. Not required if SNMP version 3 is not enabled.",
"properties": {
"authenticationType": {
"description": "The authentication protocol. When set to MD5, Message Digest 5 authentication is used. When set to SHA1, Secure Hash Algorithm 1 is used. Typical value is SHA1.",
"enum": [
"MD5",
"SHA1"
],
"type": "string"
},
"engineId": {
"description": "The configured engine ID, which is a string of 10 to 64 hexadecimal digits.",
"maxLength": 64,
"minLength": 10,
"pattern": "^[a-f0-9]{10,64}$",
"type": "string"
},
"password": {
"description": "The authentication password, associated with username. password is a string of between 8 and 64 characters. When SNMP Trap information is retrieved from the DSR via any GET operation, the password attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 64,
"minLength": 8,
"type": "string"
},
"privacyType": {
"description": "The privacy protocol. When set to AES, Advanced Encryption Standard privacy is used. When set to DES, Data Encryption Standard Privacy is used. Typical value is AES.",
"enum": [
"AES",
"DES"
],
"type": "string"
},
"securityLevel": {
"description": "The authentication and privacy options for the given username. When set to NoAuthNoPriv, username is authenticated by user name only, and Privacy (encryption) is not applied. When set to AuthNoPriv, username is authenticated via the method specified by authenticationType, and Privacy is not applied. When set to AuthPriv, username is authenticated via the method specified by authenticationType, and encryption is applied according to the privacyType value.",
"enum": [
"AuthPriv",
"AuthNoPriv",
"NoAuthNoPriv"
],
"type": "string"
},
"username": {
"description": "The SNMP username.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,32}$",
"type": "string"
}
},
"type": "object"
},
"trapsSuspended": {
"description": "Set to true by the DSR if the client suspends all traps (/admin/snmptrapping/{name}/suspend) for this SNMP trapping instance. Set to false by the DSR if the client has never suspended traps for this instance, or has resumed sending traps (/admin/snmptrapping/{name}/resume).",
"readOnly": true,
"type": "boolean"
}
},
"required": [
"configurationMode",
"sendTrapsFromIndividualServers",
"serverGroupName",
"snmpVersionsEnabled"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationMode": "PerSite",
"managers": [
{
"identifier": "199.13.47.4:180",
"enabled": false
},
{
"identifier": "SNMPManager1",
"enabled": true
}
],
"sendTrapsFromIndividualServers": false,
"serverGroupName": "SO_SG1",
"snmpVersionsEnabled": "V3",
"snmpV3Options": {
"authenticationType": "SHA1",
"engineId": "800001430c005056010224",
"password": "abcdefghij",
"privacyType": "AES",
"securityLevel": "AuthPriv",
"username": "TekSNMPUser"
},
"trapsSuspended": false
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /admin/snmptrapping
Adds a new SNMP Trapping instance to the DSR configuration. The new instance must be associated with an OAM Server Group that does not already have an instance configured for it.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/snmptrapping/snmptrapping.json",
"properties": {
"configurationMode": {
"description": "When set to Global, the SNMP trap sending configuration instance applies to every OAM Server Group (/topo/servergroups) in the DSR network - the NOAM Server Group and each SOAM Server Group. When set to PerSite, each OAM Server Group can have its own unique SNMP trap sending configuration instance.",
"enum": [
"Global",
"PerSite"
],
"type": "string"
},
"managers": {
"description": "An SNMP Trapping configuration instance can specify up to five remote managers to receive SNMP traps. Each manager specified in this array receives SNMP traps sourced by the OAM Server Group(s) governed by this SNMP Trapping configuration instance.",
"items": {
"properties": {
"identifier": {
"description": "Identifies a remote manager to receive the SNMP traps, if the manager enabled via the enabled attribute. The value for the identifier consists of a network address optionally followed by the port for the remote manager. The network address can either be a valid IPv4 or IPv6 address, or a valid hostname. The port is optional, must be an integer between 1 and 65535, inclusive, and is specified by a colon (:) and port number following the network address. If no port number follows a network address, the standard SNMP trap port 162 is used by the DSR. IPv6 addresses must appear within square brackets if the port number is specified, like this: [IPv6_address]:port. Finally, hostnames are case-insensitive and cannot exceed 255 characters.",
"maxLength": 255,
"type": "string"
},
"enabled": {
"description": "When set to true, SNMP traps are autonomously sent to the external manager by the DSR. When set to false, traps are not sent to the external manager, but can be sent to any other manager that is in the enabled state.",
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"sendTrapsFromIndividualServers": {
"description": "When set to true, SNMP traps are sent from the individual servers within the scope of this SNMP Trapping configuration instance. When set to false, system-wide traps are sent from the active NOAM server and site-specific traps are sent from active SOAM servers.",
"type": "boolean"
},
"serverGroupName": {
"description": "The name of the OAM Server Group (/topo/servergroups) to which this SNMP Trapping instance applies. Must be either the NOAM Server Group name, or the name of one of the configured SOAM Server Groups.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"snmpVersionsEnabled": {
"description": "Indicates which version(s) of SNMP is/are enabled on the DSR. Supported SNMP versions are 2c and 3. When set to V2c or V2cAndV3, snmpV2cOptions must contain valid values. When set to V2cAndV3 or V3, snmpV3Options must contain valid values. Recommended value is V3.",
"enum": [
"V2c",
"V2cAndV3",
"V3"
],
"type": "string"
},
"snmpV2cOptions": {
"description": "The configuration options that must be set if SNMP version 2c is enabled for the DSR. Not required if SNMP version 2c is not enabled.",
"properties": {
"readOnlyCommunityName": {
"description": "The read-only community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readOnlyCommunityName attribute is never present in the response - it is effectively a write-only attribute..",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
},
"readWriteCommunityName": {
"description": "The read-write community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readWriteCommunityName attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
}
},
"type": "object"
},
"snmpV3Options": {
"description": "The configuration options that must be set if SNMP version 3 is enabled for the DSR. Not required if SNMP version 3 is not enabled.",
"properties": {
"authenticationType": {
"description": "The authentication protocol. When set to MD5, Message Digest 5 authentication is used. When set to SHA1, Secure Hash Algorithm 1 is used. Typical value is SHA1.",
"enum": [
"MD5",
"SHA1"
],
"type": "string"
},
"engineId": {
"description": "The configured engine ID, which is a string of 10 to 64 hexadecimal digits.",
"maxLength": 64,
"minLength": 10,
"pattern": "^[a-f0-9]{10,64}$",
"type": "string"
},
"password": {
"description": "The authentication password, associated with username. password is a string of between 8 and 64 characters. When SNMP Trap information is retrieved from the DSR via any GET operation, the password attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 64,
"minLength": 8,
"type": "string"
},
"privacyType": {
"description": "The privacy protocol. When set to AES, Advanced Encryption Standard privacy is used. When set to DES, Data Encryption Standard Privacy is used. Typical value is AES.",
"enum": [
"AES",
"DES"
],
"type": "string"
},
"securityLevel": {
"description": "The authentication and privacy options for the given username. When set to NoAuthNoPriv, username is authenticated by user name only, and Privacy (encryption) is not applied. When set to AuthNoPriv, username is authenticated via the method specified by authenticationType, and Privacy is not applied. When set to AuthPriv, username is authenticated via the method specified by authenticationType, and encryption is applied according to the privacyType value.",
"enum": [
"AuthPriv",
"AuthNoPriv",
"NoAuthNoPriv"
],
"type": "string"
},
"username": {
"description": "The SNMP username.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,32}$",
"type": "string"
}
},
"type": "object"
},
"trapsSuspended": {
"description": "Set to true by the DSR if the client suspends all traps (/admin/snmptrapping/{name}/suspend) for this SNMP trapping instance. Set to false by the DSR if the client has never suspended traps for this instance, or has resumed sending traps (/admin/snmptrapping/{name}/resume).",
"readOnly": true,
"type": "boolean"
}
},
"required": [
"configurationMode",
"sendTrapsFromIndividualServers",
"serverGroupName",
"snmpVersionsEnabled"
],
"type": "object"
}
Example
{
"configurationMode": "PerSite",
"managers": [
{
"identifier": "199.13.47.4:180",
"enabled": false
},
{
"identifier": "SNMPManager1",
"enabled": true
}
],
"sendTrapsFromIndividualServers": false,
"serverGroupName": "SO_SG1",
"snmpVersionsEnabled": "V3",
"snmpV3Options": {
"authenticationType": "SHA1",
"engineId": "800001430c005056010224",
"password": "abcdefghij",
"privacyType": "AES",
"securityLevel": "AuthPriv",
"username": "TekSNMPUser"
},
"trapsSuspended": false
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/admin/snmptrapping/{name}
get /admin/snmptrapping/{name}
Returns the details for the specified SNMP Trapping configuration instance. The instance is specified by the name of the OAM Server Group to which it correponds. If the named instance does not exist in the DSR configuration, an error message is returned within the HTTP response.
Target Server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/items/snmptrappingItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/snmptrapping/snmptrapping.json",
"properties": {
"configurationMode": {
"description": "When set to Global, the SNMP trap sending configuration instance applies to every OAM Server Group (/topo/servergroups) in the DSR network - the NOAM Server Group and each SOAM Server Group. When set to PerSite, each OAM Server Group can have its own unique SNMP trap sending configuration instance.",
"enum": [
"Global",
"PerSite"
],
"type": "string"
},
"managers": {
"description": "An SNMP Trapping configuration instance can specify up to five remote managers to receive SNMP traps. Each manager specified in this array receives SNMP traps sourced by the OAM Server Group(s) governed by this SNMP Trapping configuration instance.",
"items": {
"properties": {
"identifier": {
"description": "Identifies a remote manager to receive the SNMP traps, if the manager enabled via the enabled attribute. The value for the identifier consists of a network address optionally followed by the port for the remote manager. The network address can either be a valid IPv4 or IPv6 address, or a valid hostname. The port is optional, must be an integer between 1 and 65535, inclusive, and is specified by a colon (:) and port number following the network address. If no port number follows a network address, the standard SNMP trap port 162 is used by the DSR. IPv6 addresses must appear within square brackets if the port number is specified, like this: [IPv6_address]:port. Finally, hostnames are case-insensitive and cannot exceed 255 characters.",
"maxLength": 255,
"type": "string"
},
"enabled": {
"description": "When set to true, SNMP traps are autonomously sent to the external manager by the DSR. When set to false, traps are not sent to the external manager, but can be sent to any other manager that is in the enabled state.",
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"sendTrapsFromIndividualServers": {
"description": "When set to true, SNMP traps are sent from the individual servers within the scope of this SNMP Trapping configuration instance. When set to false, system-wide traps are sent from the active NOAM server and site-specific traps are sent from active SOAM servers.",
"type": "boolean"
},
"serverGroupName": {
"description": "The name of the OAM Server Group (/topo/servergroups) to which this SNMP Trapping instance applies. Must be either the NOAM Server Group name, or the name of one of the configured SOAM Server Groups.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"snmpVersionsEnabled": {
"description": "Indicates which version(s) of SNMP is/are enabled on the DSR. Supported SNMP versions are 2c and 3. When set to V2c or V2cAndV3, snmpV2cOptions must contain valid values. When set to V2cAndV3 or V3, snmpV3Options must contain valid values. Recommended value is V3.",
"enum": [
"V2c",
"V2cAndV3",
"V3"
],
"type": "string"
},
"snmpV2cOptions": {
"description": "The configuration options that must be set if SNMP version 2c is enabled for the DSR. Not required if SNMP version 2c is not enabled.",
"properties": {
"readOnlyCommunityName": {
"description": "The read-only community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readOnlyCommunityName attribute is never present in the response - it is effectively a write-only attribute..",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
},
"readWriteCommunityName": {
"description": "The read-write community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readWriteCommunityName attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
}
},
"type": "object"
},
"snmpV3Options": {
"description": "The configuration options that must be set if SNMP version 3 is enabled for the DSR. Not required if SNMP version 3 is not enabled.",
"properties": {
"authenticationType": {
"description": "The authentication protocol. When set to MD5, Message Digest 5 authentication is used. When set to SHA1, Secure Hash Algorithm 1 is used. Typical value is SHA1.",
"enum": [
"MD5",
"SHA1"
],
"type": "string"
},
"engineId": {
"description": "The configured engine ID, which is a string of 10 to 64 hexadecimal digits.",
"maxLength": 64,
"minLength": 10,
"pattern": "^[a-f0-9]{10,64}$",
"type": "string"
},
"password": {
"description": "The authentication password, associated with username. password is a string of between 8 and 64 characters. When SNMP Trap information is retrieved from the DSR via any GET operation, the password attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 64,
"minLength": 8,
"type": "string"
},
"privacyType": {
"description": "The privacy protocol. When set to AES, Advanced Encryption Standard privacy is used. When set to DES, Data Encryption Standard Privacy is used. Typical value is AES.",
"enum": [
"AES",
"DES"
],
"type": "string"
},
"securityLevel": {
"description": "The authentication and privacy options for the given username. When set to NoAuthNoPriv, username is authenticated by user name only, and Privacy (encryption) is not applied. When set to AuthNoPriv, username is authenticated via the method specified by authenticationType, and Privacy is not applied. When set to AuthPriv, username is authenticated via the method specified by authenticationType, and encryption is applied according to the privacyType value.",
"enum": [
"AuthPriv",
"AuthNoPriv",
"NoAuthNoPriv"
],
"type": "string"
},
"username": {
"description": "The SNMP username.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,32}$",
"type": "string"
}
},
"type": "object"
},
"trapsSuspended": {
"description": "Set to true by the DSR if the client suspends all traps (/admin/snmptrapping/{name}/suspend) for this SNMP trapping instance. Set to false by the DSR if the client has never suspended traps for this instance, or has resumed sending traps (/admin/snmptrapping/{name}/resume).",
"readOnly": true,
"type": "boolean"
}
},
"required": [
"configurationMode",
"sendTrapsFromIndividualServers",
"serverGroupName",
"snmpVersionsEnabled"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationMode": "PerSite",
"managers": [
{
"identifier": "199.13.47.4:180",
"enabled": false
},
{
"identifier": "SNMPManager1",
"enabled": true
}
],
"sendTrapsFromIndividualServers": false,
"serverGroupName": "SO_SG1",
"snmpVersionsEnabled": "V3",
"snmpV3Options": {
"authenticationType": "SHA1",
"engineId": "800001430c005056010224",
"password": "abcdefghij",
"privacyType": "AES",
"securityLevel": "AuthPriv",
"username": "TekSNMPUser"
},
"trapsSuspended": false
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/snmptrapping/{name}
Updates the specified SNMP Trapping configuration instance. The instance is specified by the name of the OAM Server Group to which it correponds.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/snmptrapping/snmptrapping.json",
"properties": {
"configurationMode": {
"description": "When set to Global, the SNMP trap sending configuration instance applies to every OAM Server Group (/topo/servergroups) in the DSR network - the NOAM Server Group and each SOAM Server Group. When set to PerSite, each OAM Server Group can have its own unique SNMP trap sending configuration instance.",
"enum": [
"Global",
"PerSite"
],
"type": "string"
},
"managers": {
"description": "An SNMP Trapping configuration instance can specify up to five remote managers to receive SNMP traps. Each manager specified in this array receives SNMP traps sourced by the OAM Server Group(s) governed by this SNMP Trapping configuration instance.",
"items": {
"properties": {
"identifier": {
"description": "Identifies a remote manager to receive the SNMP traps, if the manager enabled via the enabled attribute. The value for the identifier consists of a network address optionally followed by the port for the remote manager. The network address can either be a valid IPv4 or IPv6 address, or a valid hostname. The port is optional, must be an integer between 1 and 65535, inclusive, and is specified by a colon (:) and port number following the network address. If no port number follows a network address, the standard SNMP trap port 162 is used by the DSR. IPv6 addresses must appear within square brackets if the port number is specified, like this: [IPv6_address]:port. Finally, hostnames are case-insensitive and cannot exceed 255 characters.",
"maxLength": 255,
"type": "string"
},
"enabled": {
"description": "When set to true, SNMP traps are autonomously sent to the external manager by the DSR. When set to false, traps are not sent to the external manager, but can be sent to any other manager that is in the enabled state.",
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"sendTrapsFromIndividualServers": {
"description": "When set to true, SNMP traps are sent from the individual servers within the scope of this SNMP Trapping configuration instance. When set to false, system-wide traps are sent from the active NOAM server and site-specific traps are sent from active SOAM servers.",
"type": "boolean"
},
"serverGroupName": {
"description": "The name of the OAM Server Group (/topo/servergroups) to which this SNMP Trapping instance applies. Must be either the NOAM Server Group name, or the name of one of the configured SOAM Server Groups.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"snmpVersionsEnabled": {
"description": "Indicates which version(s) of SNMP is/are enabled on the DSR. Supported SNMP versions are 2c and 3. When set to V2c or V2cAndV3, snmpV2cOptions must contain valid values. When set to V2cAndV3 or V3, snmpV3Options must contain valid values. Recommended value is V3.",
"enum": [
"V2c",
"V2cAndV3",
"V3"
],
"type": "string"
},
"snmpV2cOptions": {
"description": "The configuration options that must be set if SNMP version 2c is enabled for the DSR. Not required if SNMP version 2c is not enabled.",
"properties": {
"readOnlyCommunityName": {
"description": "The read-only community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readOnlyCommunityName attribute is never present in the response - it is effectively a write-only attribute..",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
},
"readWriteCommunityName": {
"description": "The read-write community name. When SNMP Trap information is retrieved from the DSR via any GET operation, the readWriteCommunityName attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 31,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,31}$",
"type": "string"
}
},
"type": "object"
},
"snmpV3Options": {
"description": "The configuration options that must be set if SNMP version 3 is enabled for the DSR. Not required if SNMP version 3 is not enabled.",
"properties": {
"authenticationType": {
"description": "The authentication protocol. When set to MD5, Message Digest 5 authentication is used. When set to SHA1, Secure Hash Algorithm 1 is used. Typical value is SHA1.",
"enum": [
"MD5",
"SHA1"
],
"type": "string"
},
"engineId": {
"description": "The configured engine ID, which is a string of 10 to 64 hexadecimal digits.",
"maxLength": 64,
"minLength": 10,
"pattern": "^[a-f0-9]{10,64}$",
"type": "string"
},
"password": {
"description": "The authentication password, associated with username. password is a string of between 8 and 64 characters. When SNMP Trap information is retrieved from the DSR via any GET operation, the password attribute is never present in the response - it is effectively a write-only attribute.",
"maxLength": 64,
"minLength": 8,
"type": "string"
},
"privacyType": {
"description": "The privacy protocol. When set to AES, Advanced Encryption Standard privacy is used. When set to DES, Data Encryption Standard Privacy is used. Typical value is AES.",
"enum": [
"AES",
"DES"
],
"type": "string"
},
"securityLevel": {
"description": "The authentication and privacy options for the given username. When set to NoAuthNoPriv, username is authenticated by user name only, and Privacy (encryption) is not applied. When set to AuthNoPriv, username is authenticated via the method specified by authenticationType, and Privacy is not applied. When set to AuthPriv, username is authenticated via the method specified by authenticationType, and encryption is applied according to the privacyType value.",
"enum": [
"AuthPriv",
"AuthNoPriv",
"NoAuthNoPriv"
],
"type": "string"
},
"username": {
"description": "The SNMP username.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[a-zA-Z0-9]{1,32}$",
"type": "string"
}
},
"type": "object"
},
"trapsSuspended": {
"description": "Set to true by the DSR if the client suspends all traps (/admin/snmptrapping/{name}/suspend) for this SNMP trapping instance. Set to false by the DSR if the client has never suspended traps for this instance, or has resumed sending traps (/admin/snmptrapping/{name}/resume).",
"readOnly": true,
"type": "boolean"
}
},
"required": [
"configurationMode",
"sendTrapsFromIndividualServers",
"serverGroupName",
"snmpVersionsEnabled"
],
"type": "object"
}
Example
{
"configurationMode": "PerSite",
"managers": [
{
"identifier": "199.13.47.4:180",
"enabled": false
},
{
"identifier": "SNMPManager1",
"enabled": true
}
],
"sendTrapsFromIndividualServers": false,
"serverGroupName": "SO_SG1",
"snmpVersionsEnabled": "V3",
"snmpV3Options": {
"authenticationType": "SHA1",
"engineId": "800001430c005056010224",
"password": "abcdefghij",
"privacyType": "AES",
"securityLevel": "AuthPriv",
"username": "TekSNMPUser"
},
"trapsSuspended": false
}
delete /admin/snmptrapping/{name}
Deletes the specified SNMP Trapping configuration instance. The instance is specified by the name of the OAM Server Group to which it corresponds.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/admin/snmptrapping/{name}/suspend
put /admin/snmptrapping/{name}/suspend
Suspends all SNMP Traps from being sent by the OAM (or its subtending servers, if so configured). The current state (suspended/not suspended) is available in the data returned by a GET response.
Target Server: NOAM or SOAM
Request
URI Parameters
- name: required (string)
Response
HTTP status code 202
Successfully suspended SNMP Traps for the specified OAM Server Group (or its subtending servers).
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
HTTP status code 400
The SNMP Traps could not be suspended for the specified OAM Server Group.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
/admin/snmptrapping/{name}/resume
put /admin/snmptrapping/{name}/resume
Resumes sending SNMP Traps from the OAM (or its subtending servers, if so configured). The current state (suspended/not suspended) is available in the data returned by a GET response.
Target Server: NOAM or SOAM
Request
URI Parameters
- name: required (string)
Response
HTTP status code 202
Successfully resumed sending SNMP Traps from the specified OAM Server Group (or its subtending servers).
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
HTTP status code 400
Sending SNMP Traps could not be resumed for the specified OAM Server Group.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Admin: Software Versions
The Software Versions resource retrieves the current DSR software version for every Server (/topo/servers) within the topology known to the OAM Server receiving the /softwareversions request.
/admin/softwareversions
get /admin/softwareversions
Retrieves the current DSR software version for every Server(/topo/servers) within the topology known to the OAM Server receiving the /softwareversions request.
Target server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/softwareversionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/softwareversion/softwareversion.json",
"properties": {
"application": {
"description": "The top-level software application (or product) for which version information is available.",
"properties": {
"hostname": {
"description": "The name of the Server (/topo/servers).",
"type": "string"
},
"name": {
"description": "The name of the software application (or product).",
"type": "string"
},
"version": {
"description": "The version of the software application (or product).",
"type": "string"
}
},
"type": "object"
},
"installedSoftware": {
"description": "The software entities installed as part of this product.",
"type": "array",
"items": {
"properties": {
"name": {
"description": "The name of the software entity.",
"type": "string"
},
"version": {
"description": "The version of the software entity.",
"type": "string"
}
},
"type": "object"
},
"minItems": 0
}
},
"readOnly": true,
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"application": {
"hostname": "NOAM01-b71f90a9",
"name": "dsr",
"version": "8.3.0.0.0-83.15.0"
},
"installedSoftware": [
{
"name": "SS7 Plug-in",
"version": "8.3.0-8.3.0_83.14.0"
},
{
"name": "HTTP Plug-in",
"version": "8.3.4-8.3.0.0.0_83.15.0"
},
{
"name": "TransportManager",
"version": "8.3.0-8.3.0_83.14.0"
},
{
"name": "ComAgent",
"version": "8.3.0-8.3.0_83.14.0"
},
{
"name": "IP Front End",
"version": "8.3.2-8.3.0.0.0_83.15.0"
}
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Admin: Users
User details are required to login to system.There are so many users belongs to specific group.before creating we should know to which user groups this user should be assigned. The group assignment determines the functions that a user has access to. If you need to create a new group for this user, you should do so before adding the user.
User configuration is created, edited, and retrieved at the NOAM, but can also be retrieved from any active SOAM server. No User configuration changes can be made at any SOAM.
/admin/users
get /admin/users
Returns all user accounts configured at the DSR.
Target Server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/admin/collections/userCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/user/user.json",
"properties": {
"accountStatus": {
"description": "This indicates whether the user account is enabled or not. By default Account Status will be false untill and unless password has set for the account.",
"default": false,
"type": "boolean"
},
"comment": {
"description": "Comments or user-defined text about this account.",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "The groups to which the selected Username is assigned. Groups define the permissions assigned to the user. The permissions determine the functions and restrictions for the users belonging to the group.",
"default": "admin",
"type": "array"
},
"mmiAccess": {
"description": "Whether the user can acces the account by Machine-to-Machine or not.",
"default": true,
"type": "boolean"
},
"maximumConcurrentLogins": {
"description": "Maximum concurrent logins per user per server.This feature cannot be enabled for users belonging to the admin group. There is no limit if the parameter value is set to 0.",
"minimum": 0,
"maximum": 50,
"default": 0,
"type": "string"
},
"sessionInactivityLimit": {
"description": "The time, in minutes, after which login session expires. Session will never expire when this parameter value is set to 0.",
"minimum": 0,
"maximum": 3600,
"default": 120,
"type": "string"
},
"useLocalAuth": {
"description": "When authentication option used with the account is using local authentication, the account is disabled until a password is established.",
"default": true,
"type": "boolean"
},
"useRemoteAuth": {
"description": "When Authentication option used with the account is remote authentication, an authentication server must be configured.",
"default": true,
"type": "boolean"
},
"username": {
"description": "A field for the Username. The Username allows access to the MMI and must be unique.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[a-z0-9]*",
"type": "string"
}
},
"required": [
"username",
"groupname",
"comment"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"comment": "New User created by superuser",
"groupname": [
"admin",
"autTestGroup"
],
"username": "tshoraff"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /admin/users
Adds a new user account. The new username must be unique within the DSR configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/user/user.json",
"properties": {
"accountStatus": {
"description": "This indicates whether the user account is enabled or not. By default Account Status will be false untill and unless password has set for the account.",
"default": false,
"type": "boolean"
},
"comment": {
"description": "Comments or user-defined text about this account.",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "The groups to which the selected Username is assigned. Groups define the permissions assigned to the user. The permissions determine the functions and restrictions for the users belonging to the group.",
"default": "admin",
"type": "array"
},
"mmiAccess": {
"description": "Whether the user can acces the account by Machine-to-Machine or not.",
"default": true,
"type": "boolean"
},
"maximumConcurrentLogins": {
"description": "Maximum concurrent logins per user per server.This feature cannot be enabled for users belonging to the admin group. There is no limit if the parameter value is set to 0.",
"minimum": 0,
"maximum": 50,
"default": 0,
"type": "string"
},
"sessionInactivityLimit": {
"description": "The time, in minutes, after which login session expires. Session will never expire when this parameter value is set to 0.",
"minimum": 0,
"maximum": 3600,
"default": 120,
"type": "string"
},
"useLocalAuth": {
"description": "When authentication option used with the account is using local authentication, the account is disabled until a password is established.",
"default": true,
"type": "boolean"
},
"useRemoteAuth": {
"description": "When Authentication option used with the account is remote authentication, an authentication server must be configured.",
"default": true,
"type": "boolean"
},
"username": {
"description": "A field for the Username. The Username allows access to the MMI and must be unique.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[a-z0-9]*",
"type": "string"
}
},
"required": [
"username",
"groupname",
"comment"
],
"type": "object"
}
Example
{
"comment": "New User created by superuser",
"groupname": [
"admin",
"autTestGroup"
],
"username": "tshoraff"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/admin/users/{username}
get /admin/users/{username}
Returns the configuration details for the specified user account. If the specified user does not exist in the NOAM's configuration, an error message is returned within the HTTP reponse.
Target Server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- username: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/user/user.json",
"properties": {
"accountStatus": {
"description": "This indicates whether the user account is enabled or not. By default Account Status will be false untill and unless password has set for the account.",
"default": false,
"type": "boolean"
},
"comment": {
"description": "Comments or user-defined text about this account.",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "The groups to which the selected Username is assigned. Groups define the permissions assigned to the user. The permissions determine the functions and restrictions for the users belonging to the group.",
"default": "admin",
"type": "array"
},
"mmiAccess": {
"description": "Whether the user can acces the account by Machine-to-Machine or not.",
"default": true,
"type": "boolean"
},
"maximumConcurrentLogins": {
"description": "Maximum concurrent logins per user per server.This feature cannot be enabled for users belonging to the admin group. There is no limit if the parameter value is set to 0.",
"minimum": 0,
"maximum": 50,
"default": 0,
"type": "string"
},
"sessionInactivityLimit": {
"description": "The time, in minutes, after which login session expires. Session will never expire when this parameter value is set to 0.",
"minimum": 0,
"maximum": 3600,
"default": 120,
"type": "string"
},
"useLocalAuth": {
"description": "When authentication option used with the account is using local authentication, the account is disabled until a password is established.",
"default": true,
"type": "boolean"
},
"useRemoteAuth": {
"description": "When Authentication option used with the account is remote authentication, an authentication server must be configured.",
"default": true,
"type": "boolean"
},
"username": {
"description": "A field for the Username. The Username allows access to the MMI and must be unique.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[a-z0-9]*",
"type": "string"
}
},
"required": [
"username",
"groupname",
"comment"
],
"type": "object"
}
Example
{
"data":
{
"comment": "New User created by superuser",
"groupname": [
"admin",
"autTestGroup"
],
"username": "tshoraff"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /admin/users/{username}
Updates the configuration for the user account. If the provided user data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- username: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/user/user.json",
"properties": {
"accountStatus": {
"description": "This indicates whether the user account is enabled or not. By default Account Status will be false untill and unless password has set for the account.",
"default": false,
"type": "boolean"
},
"comment": {
"description": "Comments or user-defined text about this account.",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"groupname": {
"description": "The groups to which the selected Username is assigned. Groups define the permissions assigned to the user. The permissions determine the functions and restrictions for the users belonging to the group.",
"default": "admin",
"type": "array"
},
"mmiAccess": {
"description": "Whether the user can acces the account by Machine-to-Machine or not.",
"default": true,
"type": "boolean"
},
"maximumConcurrentLogins": {
"description": "Maximum concurrent logins per user per server.This feature cannot be enabled for users belonging to the admin group. There is no limit if the parameter value is set to 0.",
"minimum": 0,
"maximum": 50,
"default": 0,
"type": "string"
},
"sessionInactivityLimit": {
"description": "The time, in minutes, after which login session expires. Session will never expire when this parameter value is set to 0.",
"minimum": 0,
"maximum": 3600,
"default": 120,
"type": "string"
},
"useLocalAuth": {
"description": "When authentication option used with the account is using local authentication, the account is disabled until a password is established.",
"default": true,
"type": "boolean"
},
"useRemoteAuth": {
"description": "When Authentication option used with the account is remote authentication, an authentication server must be configured.",
"default": true,
"type": "boolean"
},
"username": {
"description": "A field for the Username. The Username allows access to the MMI and must be unique.",
"minLength": 5,
"maxLength": 16,
"pattern": "^[a-z0-9]*",
"type": "string"
}
},
"required": [
"username",
"groupname",
"comment"
],
"type": "object"
}
Example
{
"comment": "New User created by superuser",
"groupname": [
"admin",
"autTestGroup"
],
"username": "tshoraff"
}
delete /admin/users/{username}
Deletes the specified user from the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- username: required (string)
/admin/users/{username}/password
put /admin/users/{username}/password
Add a password or change an existing password for the specified User account.
Target server: NOAM
Request
URI Parameters
- username: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/admin/userpassword/userpassword.json",
"properties": {
"userPassword": {
"description": "Passwords for an User account must be between 8 and 16 characters.The password must also contain 3 of these 4 types of characters:numeric, lowercase alpha, uppercase alpha, special character (!@#$%^&*?~).",
"minLength": 8,
"maxLength": 16,
"pattern": "^((?=.*[0-9])(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#$%^&*?~]).{8,16})$",
"type": "string"
}
},
"required": [
"userPassword"
],
"type": "object"
}
Example
{
"userPassword": "xxxx"
}
Response
HTTP status code 204
All: Configuration Levels
The configuration level of the database when a resource is inserted or updated.
/all/configurationlevels
get /all/configurationlevels
Returns: 1) the current database configuration level, and 2) individual resource type configuration levels for all resource types residing on the OAM server which support the configurationLevel attribute, and for which a user or client has modified the configuration in some way. If no user or client has ever modified the configuration of a resource - for example, by adding a new instance, or by editing an attribute in an option resource - then no entry for that resource appears in the data returned in the GET response.
Target Server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/all/collections/configurationlevelCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/all/configurationlevel/configurationlevel.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when the instance of the resource type is inserted or updated.",
"format": "int64",
"type": "string"
},
"resource": {
"description": "The name of the resource type.",
"type": "string"
}
},
"required": [
"configurationLevel",
"resource"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "256",
"resource": "currentConfigurationLevel"
},
{
"configurationLevel": "246",
"resource": "applicationrouterules"
},
{
"configurationLevel": "141",
"resource": "applicationroutetables"
},
{
"configurationLevel": "50",
"resource": "applicationids"
},
{
"configurationLevel": "30",
"resource": "capacityconfigurationsets"
},
{
"configurationLevel": "211",
"resource": "cexconfigurationsets"
},
{
"configurationLevel": "222",
"resource": "connections"
},
{
"configurationLevel": "181",
"resource": "connectionconfigurationsets"
},
{
"configurationLevel": "216",
"resource": "egressthrottlegroups"
},
{
"configurationLevel": "214",
"resource": "localnodes"
},
{
"configurationLevel": "111",
"resource": "messagecopyconfigurationsets"
},
{
"configurationLevel": "257",
"resource": "mpprofileassignments"
},
{
"configurationLevel": "201",
"resource": "messagepriorityconfigurationsets"
},
{
"configurationLevel": "40",
"resource": "egressmessagethrottlingconfigurationsets"
},
{
"configurationLevel": "60",
"resource": "peernodes"
},
{
"configurationLevel": "256",
"resource": "peernodegroups"
},
{
"configurationLevel": "20",
"resource": "peerrouterules"
},
{
"configurationLevel": "10",
"resource": "peerroutetables"
},
{
"configurationLevel": "121",
"resource": "pendingtransactionlimitingconfigurationsets"
},
{
"configurationLevel": "151",
"resource": "pendinganswertimers"
},
{
"configurationLevel": "131",
"resource": "ratelimitingconfigurationsets"
},
{
"configurationLevel": "236",
"resource": "reroutesonanswer"
},
{
"configurationLevel": "70",
"resource": "routegroups"
},
{
"configurationLevel": "101",
"resource": "routelists"
},
{
"configurationLevel": "161",
"resource": "routingoptionsets"
},
{
"configurationLevel": "191",
"resource": "trafficthrottlepointconfigurationsets"
},
{
"configurationLevel": "91",
"resource": "trafficthrottlegroups"
},
{
"configurationLevel": "81",
"resource": "trafficthrottlepoints"
},
{
"configurationLevel": "171",
"resource": "transactionconfigurationsets"
}
],
"messages":
[
],
"links":
{
},
"status": true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Auth: Authentication Service
Authenticates the MMI user and, if successful, creates an authentication token returned to the client.
Authentication is performed at the NOAM.
/auth/tokens
post /auth/tokens
Requests a new authentication token. The requestor is authenticated using one and only one of the following credentials:
- A valid authentication token (This is supplied in the X-Auth-Token header rather than in the form parameters)
- A username / password pair
A token is immediately usable on the server that created it. The same token is usable on other OAM servers in the topology after a short propagation delay of 3-5 seconds, assuming database replication is operational.
Target server: NOAM or SOAM
Secured by none
Secured by x-other
Request
Body
Type: application/x-www-form-urlencoded
Form Parameters- username: (string)
The user part of a username/password credential pair.
- password: (string)
The password part of a username/password credential pair.
Response
HTTP status code 201
Authentication success
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/auth/items/tokenItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/auth/token/token.json",
"type": "object",
"required": true,
"properties": {
"token": {
"description": "An authentication token",
"type": "string",
"example": "CF77CD9EC60F8791F1B",
"pattern" : "^[0-9A-F]{20}$"
},
"gooduntil": {
"description": "Authentication token expiry date / time",
"type": "string",
"example": "2015-08-04T12:36:16-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"token": "BF904A8915130B782D01",
"gooduntil": "2015-08-04T12:36:16-04:00"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 401
Authentication failure
Bulk: Bulk Configuration Service
Import (POST) and export (GET) of XML encoded topology configuration data.
Bulk configuration export requests are supported by both the NOAM and SOAM, but Bulk configuration import requests are only supported on the active or unconfigured first NOAMP.
Comagent configuration information included in the topo area is exported at the NOAM and SOAM. Application-specific configuration information may be exported at the NOAM, SOAM, or both, depending on the application itself.
Diameter configuration information included in the diameter area is exported at the NOAM and SOAM. Application-specific configuration information may be exported at the NOAM, SOAM, or both, depending on the application itself.
Fabr configuration information included in the fabr area is exported at the SOAM. Application-specific configuration information may be exported at the SOAM depending on the application itself.
Rbar configuration information included in the rbar area is exported at the SOAM. Application-specific configuration information may be exported at the SOAM depending on the application itself.
Topology configuration information included in the topo area is exported at the NOAM. Application-specific configuration information may be exported at the NOAM, SOAM, or both, depending on the application itself.
Vstp configuration information included in the vstp area is exported at the SOAM. Application-specific configuration information may be exported at the SOAM depending on the application itself.
Radius configuration information included in the radius area is exported at the NOAM and SOAM. Application-specific configuration information may be exported at the NOAM, SOAM, or both, depending on the application itself.
/bulk/configurator
get /bulk/configurator
Exports all of the configuration items available at the OAM server that receives the GET request. The configuration items are encoded in a structured XML document written to the File Management area.
The export action is asynchronous, and creates a task when the request is received. The task ID is returned, and the status of the export can be queried using Task Monitoring API (/mon/tasks/{id}). The task details includes a reference to the generated XML file in File Management.
The Export XSD schema is available at Bulk Export XSD Schema.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- area: (string)
A comma separated list of areas to include in the export. If the area name not provided, the it will export all supported areas.
- filename: (string)
Specify a filename for the export XML file generated in File Management. If the parameter is not provided a default name of 'bulkexport_{timestamp}.xml is used. The filename must be a string of length 5-255 characters. The valid characters from which the filename must be constructed are all alphanumeric characters, (period), (underscore) and (hyphen). But, the first character of the filename must be alphanumeric or (underscore).
- path: (string)
Specify a path for the export XML file generated in File Management or Export. Specified path for the export XML file is '/var/TKLC/db/filemgmt/export'.If the parameter is not provided a default path '/vat/TKLC/db/filemgmt' is used.
- scope: (string)
Specify the export will be of NOAM cofigured managed objects or SOAM configured managed objects. Possible values are - "soam" or "noam". If the parameter is not provided, then the export will contain NOAM and SOAM configured managed objects data.
Response
HTTP status code 202
Successfully started export task.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
HTTP status code 400
Export failure.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
post /bulk/configurator
The body of the request is an XML specification of Topology, Diameter, Comagent, Fabr, Rbar, Radius and Vstp configuration data. The provided data is validated before being imported, and if an item already exists, or if a validation check on an item fails, the import of that item fails but the import operation continues with the next item in the XML document. A list of any failed items is returned in the response.
To delete, update, or insert individual items, use the CRUD APIs defined for each specific configuration item.
The XSD schema, included below, can be viewed and downloaded by opening https://{target}/wsdl/Bulk.xsd
Secured by x-other
Request
Query Parameters
- area: (string)
A comma separated list of areas to include in the import. If the area name not provided, the it will import all supported areas.
- importType: (string)
Specify the importType for synchronous or asynchronous import. Possible values are - "sync" or "async". If the parameter is "async" then it's creates a task when the request is received. The task ID is returned, and the status of the import can be queried using Task Monitoring API (/mon/tasks/{id}). The task details includes a reference to the generated XML file in File Management. If the parameter is not provided a default importType "sync" is used. Synchronous call will display the result once its completed.
Body
Type: application/xml
Schema
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:simpleType name="requiredString">
<xsd:restriction base="xsd:string">
<xsd:minLength value="1" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="IPv4">
<xsd:restriction base="xsd:string">
<xsd:pattern value="(([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="IPv4orIPv6">
<xsd:restriction base="xsd:string">
<xsd:pattern value="((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))|([0-9A-Fa-f:]){1,46}|([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\.]*[0-9A-Fa-f]){0,46}" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="IPv4orIPv6NetMask">
<xsd:restriction base="xsd:string">
<xsd:pattern value="((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))|/[0-9]{1,3}" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="yesNo">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="yes" />
<xsd:enumeration value="no" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="sgLevel">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="A" />
<xsd:enumeration value="B" />
<xsd:enumeration value="C" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="serverRole">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Noam" />
<xsd:enumeration value="Soam" />
<xsd:enumeration value="Mp" />
<xsd:enumeration value="QueryServer" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="deviceType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Bonding" />
<xsd:enumeration value="Vlan" />
<xsd:enumeration value="Alias" />
<xsd:enumeration value="Ethernet" />
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="deviceInterface">
<xsd:sequence>
<xsd:element minOccurs="0" name="ipAddress" type="IPv4orIPv6" />
<xsd:element name="networkName" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="routeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Net" />
<xsd:enumeration value="Host" />
<xsd:enumeration value="Default" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="bootProtoType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="None" />
<xsd:enumeration value="Dhcp" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="monitorType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Mii" />
<xsd:enumeration value="Arp" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="arpValidationType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="None" />
<xsd:enumeration value="Active" />
<xsd:enumeration value="Backup" />
<xsd:enumeration value="All" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="svcAction">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="insert" />
<xsd:enumeration value="update" />
<xsd:enumeration value="delete" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="scopeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Server" />
<xsd:enumeration value="ServerGroup" />
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="rolePref">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Default" />
<xsd:enumeration value="Active" />
<xsd:enumeration value="Standby" />
<xsd:enumeration value="Spare" />
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="ntpServer">
<xsd:sequence>
<xsd:element name="ipAddress" type="IPv4orIPv6" />
<xsd:element name="prefer" type="xsd:boolean" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="networkElement">
<xsd:sequence>
<xsd:element name="name" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="configHostname">
<xsd:sequence>
<xsd:element name="hostname" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="network">
<xsd:sequence>
<xsd:element name="name" type="requiredString" />
<xsd:element minOccurs="0" name="UUID" type="xsd:string" />
<xsd:element minOccurs="0" name="neName" type="xsd:string" />
<xsd:element minOccurs="0" name="type" type="xsd:string" />
<xsd:element name="vlanId" type="xsd:string" />
<xsd:element name="ipAddress" type="IPv4orIPv6" />
<xsd:element name="subnetMask" type="IPv4orIPv6NetMask" />
<xsd:element minOccurs="0" name="gatewayAddress" type="IPv4orIPv6" />
<xsd:element name="isDefault" type="xsd:boolean" />
<xsd:element name="isRoutable" type="xsd:boolean" />
<xsd:element name="locked" type="xsd:boolean" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ntpref">
<xsd:sequence>
<xsd:element name="NTP_Reference" type="IPv4" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="servicePath">
<xsd:sequence>
<xsd:element name="name" type="requiredString" />
<xsd:element name="intraSitePath" type="requiredString" />
<xsd:element name="interSitePath" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="server">
<xsd:sequence>
<xsd:element name="hostname" type="requiredString" />
<xsd:element name="networkElementName" type="requiredString" />
<xsd:element minOccurs="0" name="serverGroupName" type="xsd:string" />
<xsd:element name="profileName" type="requiredString" />
<xsd:element name="location" type="xsd:string" />
<xsd:element name="role" type="serverRole" />
<xsd:element name="systemId" type="xsd:string" />
<xsd:element name="ntpServers">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="ntpServer" type="ntpServer" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="serverGroup">
<xsd:sequence>
<xsd:element name="name" type="requiredString" />
<xsd:element name="level" type="sgLevel" />
<xsd:element name="parentSgName" type="xsd:string" />
<xsd:element name="functionName" type="xsd:string" />
<xsd:element minOccurs="0" name="numWanRepConn" type="xsd:positiveInteger" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="networkDevice">
<xsd:sequence>
<xsd:element minOccurs="0" name="port" type="xsd:string" />
<xsd:element name="type" type="deviceType" />
<xsd:element minOccurs="0" name="status" type="xsd:string" />
<xsd:element minOccurs="0" name="UUID" type="xsd:string" />
<xsd:element name="hostname" type="requiredString" />
<xsd:element minOccurs="0" name="interfaces">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" minOccurs="0" name="interface" type="deviceInterface" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="options">
<xsd:complexType>
<xsd:all>
<xsd:element minOccurs="1" name="onboot" type="xsd:boolean" />
<xsd:element minOccurs="1" name="bootProto" type="bootProtoType" />
<xsd:element minOccurs="0" name="mtu" type="xsd:integer" />
<xsd:element minOccurs="0" name="baseDevice">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" minOccurs="1" name="baseDeviceItem" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element maxOccurs="1" minOccurs="0" name="monitorType" type="monitorType" />
<xsd:element maxOccurs="1" minOccurs="0" name="primary" type="xsd:string" />
<xsd:element maxOccurs="1" minOccurs="0" name="miimon" type="xsd:integer" />
<xsd:element maxOccurs="1" minOccurs="0" name="updelay" type="xsd:integer" />
<xsd:element maxOccurs="1" minOccurs="0" name="downdelay" type="xsd:integer" />
<xsd:element maxOccurs="1" minOccurs="0" name="arpInterval" type="xsd:integer" />
<xsd:element maxOccurs="1" minOccurs="0" name="arpValidate" type="arpValidationType" />
<xsd:element maxOccurs="1" minOccurs="0" name="arpIpTarget" type="xsd:string" />
<xsd:element maxOccurs="1" minOccurs="0" name="hwAddr" type="xsd:string" />
<xsd:element maxOccurs="1" minOccurs="0" name="persistentDhclient" type="xsd:string" />
<xsd:element maxOccurs="1" minOccurs="0" name="ethtoolOpts" type="xsd:string" />
<xsd:element maxOccurs="1" minOccurs="0" name="ethtoolAccelOpts" type="xsd:string" />
</xsd:all>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="networkRoute">
<xsd:sequence>
<xsd:element name="hostname" type="xsd:string" />
<xsd:element minOccurs="0" name="UUID" type="xsd:string" />
<xsd:element name="type" type="routeType" />
<xsd:element name="port" type="xsd:string" />
<xsd:element minOccurs="0" name="networkAddress" type="IPv4orIPv6" />
<xsd:element minOccurs="0" name="subnetMask" type="IPv4orIPv6NetMask" />
<xsd:element name="gatewayAddress" type="IPv4orIPv6" />
<xsd:element name="scope" type="xsd:string" />
<xsd:element name="scopeType" type="scopeType" />
<xsd:element minOccurs="0" name="status" type="xsd:string" />
<xsd:element minOccurs="0" name="statusDetails" type="xsd:string" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="resourceDomain">
<xsd:sequence>
<xsd:element name="name" type="requiredString" />
<xsd:element name="profileName" type="xsd:string" />
<xsd:element minOccurs="0" name="sgNames">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="sgName" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="place">
<xsd:sequence>
<xsd:element name="name" type="requiredString" />
<xsd:element minOccurs="0" name="parentPlaceName" type="xsd:string" />
<xsd:element name="typeName" type="requiredString" />
<xsd:element minOccurs="0" name="serverList">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="serverListItem" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="placeAssociation">
<xsd:sequence>
<xsd:element name="name" type="requiredString" />
<xsd:element name="typeName" type="requiredString" />
<xsd:element minOccurs="0" name="placeList">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="placeListItem" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="dscpInterfaceRule">
<xsd:sequence>
<xsd:element minOccurs="0" name="UUID" type="xsd:string" />
<xsd:element name="interface" type="requiredString" />
<xsd:element name="dscp" type="xsd:integer" />
<xsd:element name="protocol" type="protocolType" />
<xsd:element name="scope" type="xsd:string" />
<xsd:element name="scopeType" type="scopeType" />
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="protocolType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Tcp" />
<xsd:enumeration value="Sctp" />
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="dscpPortRule">
<xsd:sequence>
<xsd:element minOccurs="0" name="UUID" type="xsd:string" />
<xsd:element name="port" type="xsd:integer" />
<xsd:element name="dscp" type="xsd:integer" />
<xsd:element name="protocol" type="protocolType" />
<xsd:element name="scope" type="xsd:string" />
<xsd:element name="scopeType" type="scopeType" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="vip">
<xsd:sequence>
<xsd:element minOccurs="0" name="UUID" type="xsd:string" />
<xsd:element name="serverGroupName" type="requiredString" />
<xsd:element name="ipAddress" type="IPv4orIPv6" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="member">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="haRolePreference" type="rolePref" />
<xsd:element maxOccurs="1" minOccurs="1" name="hostname" type="requiredString" />
<xsd:element maxOccurs="1" minOccurs="1" name="serverGroupName" type="requiredString" />
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="topoArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="configHostname" type="configHostname" />
<xsd:element name="networkElement" type="networkElement" />
<xsd:element name="network" type="network" />
<xsd:element name="servicePath" type="servicePath" />
<xsd:element name="server" type="server" />
<xsd:element name="serverGroup" type="serverGroup" />
<xsd:element name="networkDevice" type="networkDevice" />
<xsd:element name="networkRoute" type="networkRoute" />
<xsd:element name="resourceDomain" type="resourceDomain" />
<xsd:element name="place" type="place" />
<xsd:element name="placeAssociation" type="placeAssociation" />
<xsd:element name="dscpInterfaceRule" type="dscpInterfaceRule" />
<xsd:element name="dscpPortRule" type="dscpPortRule" />
<xsd:element name="member" type="member" />
<xsd:element name="vip" type="vip" />
</xsd:choice>
</xsd:complexType>
<xsd:element name="configuration">
<xsd:complexType>
<xsd:all>
<xsd:element minOccurs="0" name="topo" type="topoArea" />
</xsd:all>
</xsd:complexType>
</xsd:element>
</xsd:schema>
ComAgent: Connection Groups
Connection Group provides the means to group Communication Agent Connections for the purpose of traffic load balancing. There is at least one, and can be up to three predefined Connection Groups. A Connection Group can be associated with many peer servers. These peer servers can be Remote Servers or they can be on routable remote networks. A Connection Group can have up to 16 Remote Servers that are associated to a local MP.
/comagent/connectiongroups
get /comagent/connectiongroups
Returns all Connection Groups configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Connection Groups meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/collections/connectiongroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/connectiongroups/connectiongroup.json",
"properties": {
"assignedServers": {
"description": "List of Servers that are assigned to this group are listed by their names.",
"type": "array",
"items": {
"description": "Remote server name.",
"maxLength": 32,
"pattern": "^([a-zA-Z0-9_]([a-zA-Z0-9\\_\\-\\.]*[a-zA-Z0-9])?)$",
"type": "string"
},
"minItems": 0
},
"name": {
"description": "The name of the Connection Group within the system.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"readOnly": true,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"assignedServers": [
"mmiComagent1",
"mmiComagent2"
],
"name": "DPSvcGroup"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/comagent/connectiongroups/{name}
get /comagent/connectiongroups/{name}
Returns the configuration details for the specified Connection Group. If the specified Connection Group does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/connectiongroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/connectiongroups/connectiongroup.json",
"properties": {
"assignedServers": {
"description": "List of Servers that are assigned to this group are listed by their names.",
"type": "array",
"items": {
"description": "Remote server name.",
"maxLength": 32,
"pattern": "^([a-zA-Z0-9_]([a-zA-Z0-9\\_\\-\\.]*[a-zA-Z0-9])?)$",
"type": "string"
},
"minItems": 0
},
"name": {
"description": "The name of the Connection Group within the system.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"readOnly": true,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"assignedServers": [
"mmiComagent1",
"mmiComagent2"
],
"name": "DPSvcGroup"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /comagent/connectiongroups/{name}
Updates the configuration for the specified Connection Group. If the provided Connection Group data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/connectiongroups/connectiongroup.json",
"properties": {
"assignedServers": {
"description": "List of Servers that are assigned to this group are listed by their names.",
"type": "array",
"items": {
"description": "Remote server name.",
"maxLength": 32,
"pattern": "^([a-zA-Z0-9_]([a-zA-Z0-9\\_\\-\\.]*[a-zA-Z0-9])?)$",
"type": "string"
},
"minItems": 0
},
"name": {
"description": "The name of the Connection Group within the system.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"readOnly": true,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"assignedServers": [
"mmiComagent1",
"mmiComagent2"
],
"name": "DPSvcGroup"
}
ComAgent: Connection Status
Connection Status shows the Automatic and Configured connections of specified connection to or from a local server.
/comagent/connections/status
get /comagent/connections/status
Returns the status of all connections that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. The name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE.
Target Server: SOAM and NOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
Returns the status of all Connections that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. The Server Name, Admin State, Operational State attributes can be filtered using EQUAL, NOT_EQUAL, ISNULL or LIKE.
Example:
filter_name=adminState
- filter_op: (one of EQUAL, NOT_EQUAL, ISNULL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=Enabled
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/collections/connectionstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/connectionstatus/connectionstatus.json",
"properties": {
"automaticConnections": {
"description": "Number of Automatic Connections that are InService or Degraded from all Automatic Connections in service.",
"type": "string"
},
"configuredConnections": {
"description": "Number of Configured Connections that are InService or Degraded from all Configured Connections in Service.",
"type": "string"
},
"serverName": {
"description": "The Name of comagent remote server in system.",
"type": "string"
},
"serverStatus": {
"description": "Status of each remote server.",
"items": {
"description": "peer server details of specific server.",
"properties": {
"adminConnectionState": {
"description": "Admin state of connection.",
"enum": [
"Enabled",
"Disabled",
"Blocked"
],
"type": "string"
},
"connectionStatus": {
"description": "Current operational state of the connection at local end.",
"enum": [
"Down",
"Forming",
"Aligning",
"LocallyBlocked",
"RemotelyBlocked",
"TotallyBlocked",
"InService",
"Degraded"
],
"type": "string"
},
"connectionType": {
"description": "Type of connection of the server.",
"enum": [
"Auto",
"Configured"
],
"type": "string"
},
"DateLastUpdated": {
"description": "Time when the connection status was last updated.",
"type": "string"
},
"peerServerIpAddress": {
"description": "The IP address of the peer server that displays may be IPv4 or IPv6 based on the established connection.",
"maximum": 39,
"minimum": 3,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"peerServerName": {
"description": "All servers local and remote that have connections to respective server are listed.",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this connection Status, statusKnown is set to true.",
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"automaticConnections": "1 of 1 InService",
"serverName": {
"adminConnectionState": "Enabled",
"connectionStatus": "InService",
"connectionType": "Auto",
"dateLastUpdated": "2018-Apr-11 06:12:27:78 EDT",
"peerServerIpAddress": "192.168.2.103",
"peerServerName": "DsrMP1"
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/comagent/connections/{name}/status
get /comagent/connections/{name}/status
We can get summary or detailed report of a specific peer server.
Target Server: SOAM and NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/connectionstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/connectionstatus/connectionstatus.json",
"properties": {
"automaticConnections": {
"description": "Number of Automatic Connections that are InService or Degraded from all Automatic Connections in service.",
"type": "string"
},
"configuredConnections": {
"description": "Number of Configured Connections that are InService or Degraded from all Configured Connections in Service.",
"type": "string"
},
"serverName": {
"description": "The Name of comagent remote server in system.",
"type": "string"
},
"serverStatus": {
"description": "Status of each remote server.",
"items": {
"description": "peer server details of specific server.",
"properties": {
"adminConnectionState": {
"description": "Admin state of connection.",
"enum": [
"Enabled",
"Disabled",
"Blocked"
],
"type": "string"
},
"connectionStatus": {
"description": "Current operational state of the connection at local end.",
"enum": [
"Down",
"Forming",
"Aligning",
"LocallyBlocked",
"RemotelyBlocked",
"TotallyBlocked",
"InService",
"Degraded"
],
"type": "string"
},
"connectionType": {
"description": "Type of connection of the server.",
"enum": [
"Auto",
"Configured"
],
"type": "string"
},
"DateLastUpdated": {
"description": "Time when the connection status was last updated.",
"type": "string"
},
"peerServerIpAddress": {
"description": "The IP address of the peer server that displays may be IPv4 or IPv6 based on the established connection.",
"maximum": 39,
"minimum": 3,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"peerServerName": {
"description": "All servers local and remote that have connections to respective server are listed.",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this connection Status, statusKnown is set to true.",
"type": "boolean"
}
},
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"automaticConnections": "1 of 1 InService",
"serverName": {
"adminConnectionState": "Enabled",
"connectionStatus": "InService",
"connectionType": "Auto",
"dateLastUpdated": "2018-Apr-11 06:12:27:78 EDT",
"peerServerIpAddress": "192.168.2.103",
"peerServerName": "DsrMP1"
}
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/comagent/connections/{name}/connectionstatusadminstate
get /comagent/connections/{name}/connectionstatusadminstate
Retrieves the administrative state for the specified Connection, which can be Enabled, Disabled or Blocked.
Target server: SOAM and NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/connectionstatusadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/connectionstatus/connectionstatusadminstate.json",
"properties": {
"adminConnectionState": {
"description": "A connection status's administrative state can be either Enabled, Disabled or Block.",
"enum": [
"Enabled",
"Disabled",
"Blocked"
],
"default": "Enabled",
"type": "string"
}
},
"required": [
"adminConnectionState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminConnectionState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /comagent/connections/{name}/connectionstatusadminstate
Updates the administrative state for the specified Connection Status to either Enabled, Disabled or Blocked.
Target server: SOAM and NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/connectionstatus/connectionstatusadminstate.json",
"properties": {
"adminConnectionState": {
"description": "A connection status's administrative state can be either Enabled, Disabled or Block.",
"enum": [
"Enabled",
"Disabled",
"Blocked"
],
"default": "Enabled",
"type": "string"
}
},
"required": [
"adminConnectionState"
],
"type": "object"
}
Example
{
"adminConnectionState": "Enabled"
}
ComAgent: HA Services
A server application configures the High-Availability (HA) Framework to manage its Resources and Sub-Resources, and based upon the configuration and on the health scores of participating servers, the HA Framework assigns states to each Sub-Resource on each server.
If a Resource or Sub-Resource is Active on a given server, then the server application on that server is actively providing the software function associated with the Resource or Sub-Resource.
If a Resource or Sub-Resource is Standby, Spare, Observer, or Out-of-Service, then the server application is not actively providing the function, but instead is waiting to be promoted to Active. The Resource or Sub-Resource got demoted from Active on some other server due to failures results into reducing the other servers health score also.
The HA Services Status screen shows the status as seen from a reporting server. The reporting server may be a provider of the HA Service or it may be a user of HA Services.
/comagent/haservices/status
get /comagent/haservices/status
Returns the status of all HA Service Resources that meet the criteria specified in the request.
Target Server: NOAM and SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/collections/haservicestatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/haservice/haservicestatus.json",
"properties": {
"haResourceProviderStatus": {
"description": "It displays the status detail about HA provider for HA resource and sub-resource pair.",
"items": {
"properties": {
"activeSR": {
"description": "It represents total number of HA Providers publishing Active state for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"multipleActive": {
"description": "If true, HA User detects multiple Active Providers for corresponding HA Resource + sub-resource pair.",
"readOnly": true,
"type": "boolean"
},
"registeredSR": {
"description": "It shows total number of HA providers registered for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"activeSR",
"multipleActive",
"registeredSR"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"haResourceUserStatus": {
"description": "It displays the status detail about HA user routing for HA resource and sub-resource pair.",
"items": {
"properties": {
"alarmCount": {
"description": "It represents total number of HA resource alarms raised by HA User with Critical,Major,Minor severity.",
"items": {
"properties": {
"criticalCount": {
"description": "It shows total number of HA resource alarms raised by HA User with Critical severity.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"majorCount": {
"description": "It shows total number of HA resource alarms raised by HA User with Major severity.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"minorCount": {
"description": "It shows total number of HA resource alarms raised by HA User with Minor severity.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"criticalCount",
"majorCount",
"minorCount"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"routingStateCount": {
"description": "It represents total number of HA Providers for Available,Degraded,Unavailable state of corresponding HA Resource + sub-resource pair.",
"items": {
"properties": {
"availableStateCount": {
"description": "It shows total number of HA Users that have routing status as Available for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"degradedStateCount": {
"description": "It shows total number of HA Users that have routing status as Degraded for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"unavailableStateCount": {
"description": "It shows total number of HA Users that have routing status as Unavailable for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"availableStateCount",
"degradedStateCount",
"unavailableStateCount"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"totalSR": {
"description": "It shows total number of HA Users registered for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"alaramCount",
"routingStateCount",
"totalSR"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"resource": {
"description": "List of Resources that are registered by any HA user or provider server(s).",
"maxLength": 32,
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"haResourceProviderStatus": [
{
"activeSR": 8,
"multipleActive": 8,
"registeredSR": false
}
],
"haResourceUserStatus": [
{
"alarmCount": [
{
"criticalCount": 0,
"majorCount": 0,
"minorCount": 0
}
],
"routingStateCount": [
{
"availableStateCount": 32,
"degradedStateCount": 0,
"unavailableStateCount": 0
}
],
"totalSR": 32
}
],
"resource": "SessionRD"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/comagent/haservices/resource/{resourcename}/status
get /comagent/haservices/resource/{resourcename}/status
Retrieves the all sub-resource details as well as user and provider details for particular configured Resource.
Target Server: NOAM and SOAM
Secured by x-other
Request
URI Parameters
- resourcename: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/haserviceresourcestatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/haservice/resource/haserviceresourcestatus.json",
"properties": {
"haProviderReportStatus": {
"description": "It displays the reporting status details about HA provider for HA resource and sub-resource pair.",
"items": {
"properties": {
"hostName": {
"description": "It displays provider server that have registered for corresponding HA Resource + sub resource. When server is selected in provider pane, then it displays only those user servers that have status data available from selected provider server",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"state": {
"description": "It shows HA state as published by corresponding provider server.",
"enum": [
"Active",
"Auditing",
"Observer",
"OutOfSrvc",
"Spare",
"StandBy"
],
"readOnly": true,
"type": "string"
},
"updateTime": {
"description": "It displays the date/time at which HA status for corresponding provider server has updated by the application.",
"readOnly": true,
"type": "string"
}
},
"required": [
"hostName",
"state",
"updateTime"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"haProviderServerStatus": {
"description": "It displays the status detail about HA provider for HA resource and sub-resource pair.",
"items": {
"properties": {
"active": {
"description": "It represents total number of HA Providers publishing Active state for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"total": {
"description": "It shows total number of HA providers registered for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"total",
"active"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"haUserReportStatus": {
"description": "It displays the reporting status details about HA user routing for HA resource and sub-resource pair.",
"items": {
"properties": {
"congestionLevel": {
"description": "Tells application congestion level.",
"enum": [
"Critical",
"Major",
"Minor",
"Normal"
],
"readOnly": true,
"type": "string"
},
"hostName": {
"description": "Displays user servers that have registered for corresponding HA Resource + sub-resource.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"multipleActive": {
"description": "If true, HA User detects multiple Active Users for corresponding HA Resource + sub-resource pair. When Provider server is selected in Provider pane, then it displays ---- for this field.",
"readOnly": true,
"type": "boolean"
},
"provider": {
"description": "Displays name of the Provider server for which HA Role is being displayed. If the corresponding user server does not have status data from any Provider, then it displays ---- . When server is selected in user pane, then it displays only those user servers that have status data available from selected user server",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"routingstatus": {
"description": "Displays routing status of HA Resource + sub-resource pair at corresponding user server. If there exist a Provider with Active HA role, then it displays routing status as Available or Degraded (Based on congestion level with that provider), otherwise it displays UnAvailable.",
"enum": [
"Available",
"Degraded",
"UnAvailable"
],
"readOnly": true,
"type": "string"
},
"state": {
"description": "It shows HA role state as published by corresponding provider server. If the corresponding user server does not have status data from any Provider, then it displays HA Role as OutOfSrvc.",
"enum": [
"Active",
"Auditing",
"Observer",
"OutOfSrvc",
"Spare",
"StandBy"
],
"readOnly": true,
"type": "string"
},
"updateTime": {
"description": "It dispalys the date/time at which HA status for corresponding provider server has updated by the application.",
"readOnly": true,
"type": "string"
}
},
"required": [
"congestionLevel",
"hostName",
"multipleActive",
"provider",
"routingstatus",
"state",
"updateTime"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"haUserServerStatus": {
"description": "It displays the status detail about HA user routing for HA resource and sub-resource pair.",
"items": {
"properties": {
"multipleActive": {
"description": "If true, HA User detects multiple Active Users for corresponding HA Resource + sub-resource pair.",
"readOnly": true,
"type": "boolean"
},
"routingStateCount": {
"description": "It represents total number of HA Users for Available,Degraded,Unavailable state of corresponding HA Resource + sub-resource pair.",
"items": {
"properties": {
"availableStateCount": {
"description": "It shows total number of HA Users that have routing status as Available for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"degradedStateCount": {
"description": "It shows total number of HA Users that have routing status as Degraded for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"unavailableStateCount": {
"description": "It shows total number of HA Users that have routing status as Unavailable for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"availableStateCount",
"degradedStateCount",
"unavailableStateCount"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"total": {
"description": "It shows total number of HA Users registered for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"multipleActive",
"total",
"routingStateCount"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"subResource": {
"description": "List of Sub-Resources IDs (of selected HA Resource from tab) registered by any HA user or provider server(s).",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this HA service are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this HA service. If the OAM has current status for this HA service, statusKnown is set to true.",
"readOnly": true,
"type": "boolean"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"haProviderReportStatus": [
{
"hostName": "HPC-sPSBR1",
"state": "Active",
"updateTime": "2018-Apr-16 11:05:05 EDT"
}
],
"haProviderServerStatus": [
{
"active": 1,
"total": 2
}
],
"haUserReportStatus": [
{
"congestionLevel": "Normal",
"hostName": "HPC-MP1",
"multipleActive": false,
"provider": "HPC-sPSBR1",
"routingstatus": "Available",
"state": "Active",
"updateTime": "2018-Apr-16 11:05:05 EDT"
}
],
"haUserServerStatus": [
{
"multipleActive": false,
"routingStateCount": [
{
"availableStateCount": 4,
"degradedStateCount": 0,
"unavailableStateCount": 0
}
],
"total": 4
}
],
"subResource": 0,
"statusKnown": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/comagent/haservices/resource/{resourcename}/subresource/{subresourcename}/status
get /comagent/haservices/resource/{resourcename}/subresource/{subresourcename}/status
Retrieves the sub-resource details as well as user and provider (on providing subresource id as part of url along with resource name) user and provider details for particular configured Resource.
Target Server: NOAM and SOAM
Secured by x-other
Request
URI Parameters
- resourcename: required (string)
- subresourcename: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/haserviceresourcestatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/haservice/resource/haserviceresourcestatus.json",
"properties": {
"haProviderReportStatus": {
"description": "It displays the reporting status details about HA provider for HA resource and sub-resource pair.",
"items": {
"properties": {
"hostName": {
"description": "It displays provider server that have registered for corresponding HA Resource + sub resource. When server is selected in provider pane, then it displays only those user servers that have status data available from selected provider server",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"state": {
"description": "It shows HA state as published by corresponding provider server.",
"enum": [
"Active",
"Auditing",
"Observer",
"OutOfSrvc",
"Spare",
"StandBy"
],
"readOnly": true,
"type": "string"
},
"updateTime": {
"description": "It displays the date/time at which HA status for corresponding provider server has updated by the application.",
"readOnly": true,
"type": "string"
}
},
"required": [
"hostName",
"state",
"updateTime"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"haProviderServerStatus": {
"description": "It displays the status detail about HA provider for HA resource and sub-resource pair.",
"items": {
"properties": {
"active": {
"description": "It represents total number of HA Providers publishing Active state for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"total": {
"description": "It shows total number of HA providers registered for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"total",
"active"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"haUserReportStatus": {
"description": "It displays the reporting status details about HA user routing for HA resource and sub-resource pair.",
"items": {
"properties": {
"congestionLevel": {
"description": "Tells application congestion level.",
"enum": [
"Critical",
"Major",
"Minor",
"Normal"
],
"readOnly": true,
"type": "string"
},
"hostName": {
"description": "Displays user servers that have registered for corresponding HA Resource + sub-resource.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"multipleActive": {
"description": "If true, HA User detects multiple Active Users for corresponding HA Resource + sub-resource pair. When Provider server is selected in Provider pane, then it displays ---- for this field.",
"readOnly": true,
"type": "boolean"
},
"provider": {
"description": "Displays name of the Provider server for which HA Role is being displayed. If the corresponding user server does not have status data from any Provider, then it displays ---- . When server is selected in user pane, then it displays only those user servers that have status data available from selected user server",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"routingstatus": {
"description": "Displays routing status of HA Resource + sub-resource pair at corresponding user server. If there exist a Provider with Active HA role, then it displays routing status as Available or Degraded (Based on congestion level with that provider), otherwise it displays UnAvailable.",
"enum": [
"Available",
"Degraded",
"UnAvailable"
],
"readOnly": true,
"type": "string"
},
"state": {
"description": "It shows HA role state as published by corresponding provider server. If the corresponding user server does not have status data from any Provider, then it displays HA Role as OutOfSrvc.",
"enum": [
"Active",
"Auditing",
"Observer",
"OutOfSrvc",
"Spare",
"StandBy"
],
"readOnly": true,
"type": "string"
},
"updateTime": {
"description": "It dispalys the date/time at which HA status for corresponding provider server has updated by the application.",
"readOnly": true,
"type": "string"
}
},
"required": [
"congestionLevel",
"hostName",
"multipleActive",
"provider",
"routingstatus",
"state",
"updateTime"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"haUserServerStatus": {
"description": "It displays the status detail about HA user routing for HA resource and sub-resource pair.",
"items": {
"properties": {
"multipleActive": {
"description": "If true, HA User detects multiple Active Users for corresponding HA Resource + sub-resource pair.",
"readOnly": true,
"type": "boolean"
},
"routingStateCount": {
"description": "It represents total number of HA Users for Available,Degraded,Unavailable state of corresponding HA Resource + sub-resource pair.",
"items": {
"properties": {
"availableStateCount": {
"description": "It shows total number of HA Users that have routing status as Available for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"degradedStateCount": {
"description": "It shows total number of HA Users that have routing status as Degraded for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"unavailableStateCount": {
"description": "It shows total number of HA Users that have routing status as Unavailable for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"availableStateCount",
"degradedStateCount",
"unavailableStateCount"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"total": {
"description": "It shows total number of HA Users registered for corresponding HA Resource + sub-resource pair.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
}
},
"required": [
"multipleActive",
"total",
"routingStateCount"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"subResource": {
"description": "List of Sub-Resources IDs (of selected HA Resource from tab) registered by any HA user or provider server(s).",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this HA service are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this HA service. If the OAM has current status for this HA service, statusKnown is set to true.",
"readOnly": true,
"type": "boolean"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"haProviderReportStatus": [
{
"hostName": "HPC-sPSBR1",
"state": "Active",
"updateTime": "2018-Apr-16 11:05:05 EDT"
}
],
"haProviderServerStatus": [
{
"active": 1,
"total": 2
}
],
"haUserReportStatus": [
{
"congestionLevel": "Normal",
"hostName": "HPC-MP1",
"multipleActive": false,
"provider": "HPC-sPSBR1",
"routingstatus": "Available",
"state": "Active",
"updateTime": "2018-Apr-16 11:05:05 EDT"
}
],
"haUserServerStatus": [
{
"multipleActive": false,
"routingStateCount": [
{
"availableStateCount": 4,
"degradedStateCount": 0,
"unavailableStateCount": 0
}
],
"total": 4
}
],
"subResource": 0,
"statusKnown": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
ComAgent: Remote Servers
A remote server is a server that has a different parent OA&M server-pair relative to a local MP server group. The remote servers are associated with servers in a local server group. Connections are established between Remote server and local servers in the specified server group.
/comagent/remoteservers
get /comagent/remoteservers
Returns all Remote Servers associated with servers in various local server groups configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Remote Servers meeting the request parameters are returned in the response.
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/collections/remoteserverCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/remoteservers/remoteserver.json",
"properties": {
"ipAddressPreference": {
"description": "Identifies the Preferred IP Address for connection establishment.",
"enum": [
"GlobalConfig",
"Ipv4",
"Ipv6"
],
"default": "GlobalConfig",
"type": "string"
},
"localServerGroup": {
"description": "Identifies the Local Server Group associated with the Remote Server. The name of the group of local servers that establish connections with this Remote Server.",
"items": {
"description": "This field specifies the Server Groups which can be associated with the Remote Server. The Servers in these Server Groups establish connections with this Remote Server. Server Groups which are available will be in the Available Local Server Groups list. Server Groups which are associated with the Remote Server will be in the Assigned Local Server Groups list.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"name": {
"description": "The Remote Server Name is a unique name within the system that can be repeated to associate it with multiple Local Server Groups.",
"maxLength": 32,
"pattern": "^([a-zA-Z0-9_]([a-zA-Z0-9\\_\\-\\.]*[a-zA-Z0-9])?)$",
"type": "string"
},
"remoteServerIPv4Address": {
"description": "The IPv4 address of the Remote Server.",
"minLength": 0,
"maxLength": 15,
"pattern": "^([0-9]{1,3})(\\.[0-9]{1,3}){3}$",
"type": "string"
},
"remoteServerIPv6Address": {
"description": "The IPv6 address of the Remote Server.",
"minLength": 0,
"maxLength": 40,
"pattern": "^\\s*((([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}|((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:)))(%.+)?\\s*$",
"type": "string"
},
"remoteServerMode": {
"description": "The mode in which the Remote Server operates.",
"enum": [
"Client",
"Server"
],
"type": "string"
}
},
"required": [
"localServerGroup",
"name",
"remoteServerMode"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"ipAddressPreference": "Ipv4",
"localServerGroup": [
"MP_SG_1",
"MP_SG_2"
],
"name": "mmiComagent1",
"remoteServerIPv4Address": "10.75.245.1",
"remoteServerMode": "Client"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /comagent/remoteservers
Adds a new Remote Server to the ComAgent configuration. The Remote Server Name and Remote Server IPv4/IPV6 IP Address for a Remote Server shall not be overlapping or shall not already exists in the NOAM's configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/remoteservers/remoteserver.json",
"properties": {
"ipAddressPreference": {
"description": "Identifies the Preferred IP Address for connection establishment.",
"enum": [
"GlobalConfig",
"Ipv4",
"Ipv6"
],
"default": "GlobalConfig",
"type": "string"
},
"localServerGroup": {
"description": "Identifies the Local Server Group associated with the Remote Server. The name of the group of local servers that establish connections with this Remote Server.",
"items": {
"description": "This field specifies the Server Groups which can be associated with the Remote Server. The Servers in these Server Groups establish connections with this Remote Server. Server Groups which are available will be in the Available Local Server Groups list. Server Groups which are associated with the Remote Server will be in the Assigned Local Server Groups list.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"name": {
"description": "The Remote Server Name is a unique name within the system that can be repeated to associate it with multiple Local Server Groups.",
"maxLength": 32,
"pattern": "^([a-zA-Z0-9_]([a-zA-Z0-9\\_\\-\\.]*[a-zA-Z0-9])?)$",
"type": "string"
},
"remoteServerIPv4Address": {
"description": "The IPv4 address of the Remote Server.",
"minLength": 0,
"maxLength": 15,
"pattern": "^([0-9]{1,3})(\\.[0-9]{1,3}){3}$",
"type": "string"
},
"remoteServerIPv6Address": {
"description": "The IPv6 address of the Remote Server.",
"minLength": 0,
"maxLength": 40,
"pattern": "^\\s*((([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}|((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:)))(%.+)?\\s*$",
"type": "string"
},
"remoteServerMode": {
"description": "The mode in which the Remote Server operates.",
"enum": [
"Client",
"Server"
],
"type": "string"
}
},
"required": [
"localServerGroup",
"name",
"remoteServerMode"
],
"type": "object"
}
Example
{
"ipAddressPreference": "Ipv4",
"localServerGroup": [
"MP_SG_1",
"MP_SG_2"
],
"name": "mmiComagent1",
"remoteServerIPv4Address": "10.75.245.1",
"remoteServerMode": "Client"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/comagent/remoteservers/{name}
get /comagent/remoteservers/{name}
Returns the configuration details for the specified Remote Server. If the specified Remote Server does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/remoteserverItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/remoteservers/remoteserver.json",
"properties": {
"ipAddressPreference": {
"description": "Identifies the Preferred IP Address for connection establishment.",
"enum": [
"GlobalConfig",
"Ipv4",
"Ipv6"
],
"default": "GlobalConfig",
"type": "string"
},
"localServerGroup": {
"description": "Identifies the Local Server Group associated with the Remote Server. The name of the group of local servers that establish connections with this Remote Server.",
"items": {
"description": "This field specifies the Server Groups which can be associated with the Remote Server. The Servers in these Server Groups establish connections with this Remote Server. Server Groups which are available will be in the Available Local Server Groups list. Server Groups which are associated with the Remote Server will be in the Assigned Local Server Groups list.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"name": {
"description": "The Remote Server Name is a unique name within the system that can be repeated to associate it with multiple Local Server Groups.",
"maxLength": 32,
"pattern": "^([a-zA-Z0-9_]([a-zA-Z0-9\\_\\-\\.]*[a-zA-Z0-9])?)$",
"type": "string"
},
"remoteServerIPv4Address": {
"description": "The IPv4 address of the Remote Server.",
"minLength": 0,
"maxLength": 15,
"pattern": "^([0-9]{1,3})(\\.[0-9]{1,3}){3}$",
"type": "string"
},
"remoteServerIPv6Address": {
"description": "The IPv6 address of the Remote Server.",
"minLength": 0,
"maxLength": 40,
"pattern": "^\\s*((([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}|((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:)))(%.+)?\\s*$",
"type": "string"
},
"remoteServerMode": {
"description": "The mode in which the Remote Server operates.",
"enum": [
"Client",
"Server"
],
"type": "string"
}
},
"required": [
"localServerGroup",
"name",
"remoteServerMode"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ipAddressPreference": "Ipv4",
"localServerGroup": [
"MP_SG_1",
"MP_SG_2"
],
"name": "mmiComagent1",
"remoteServerIPv4Address": "10.75.245.1",
"remoteServerMode": "Client"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /comagent/remoteservers/{name}
Updates the configuration for the specified Remote Server. The server group associating with the remote server should not conflict with the constraint in connection group that connection being assigned to connection group do not have more than 16 remote servers that are associated to same local server group. If the provided Remote Server data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/remoteservers/remoteserver.json",
"properties": {
"ipAddressPreference": {
"description": "Identifies the Preferred IP Address for connection establishment.",
"enum": [
"GlobalConfig",
"Ipv4",
"Ipv6"
],
"default": "GlobalConfig",
"type": "string"
},
"localServerGroup": {
"description": "Identifies the Local Server Group associated with the Remote Server. The name of the group of local servers that establish connections with this Remote Server.",
"items": {
"description": "This field specifies the Server Groups which can be associated with the Remote Server. The Servers in these Server Groups establish connections with this Remote Server. Server Groups which are available will be in the Available Local Server Groups list. Server Groups which are associated with the Remote Server will be in the Assigned Local Server Groups list.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"type": "string"
},
"minItems": 1,
"type": "array"
},
"name": {
"description": "The Remote Server Name is a unique name within the system that can be repeated to associate it with multiple Local Server Groups.",
"maxLength": 32,
"pattern": "^([a-zA-Z0-9_]([a-zA-Z0-9\\_\\-\\.]*[a-zA-Z0-9])?)$",
"type": "string"
},
"remoteServerIPv4Address": {
"description": "The IPv4 address of the Remote Server.",
"minLength": 0,
"maxLength": 15,
"pattern": "^([0-9]{1,3})(\\.[0-9]{1,3}){3}$",
"type": "string"
},
"remoteServerIPv6Address": {
"description": "The IPv6 address of the Remote Server.",
"minLength": 0,
"maxLength": 40,
"pattern": "^\\s*((([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}|((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){5}(((:[0-9A-Fa-f]{1,4}){1,2})|:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3})|:))|(([0-9A-Fa-f]{1,4}:){4}(((:[0-9A-Fa-f]{1,4}){1,3})|((:[0-9A-Fa-f]{1,4})?:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){3}(((:[0-9A-Fa-f]{1,4}){1,4})|((:[0-9A-Fa-f]{1,4}){0,2}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){2}(((:[0-9A-Fa-f]{1,4}){1,5})|((:[0-9A-Fa-f]{1,4}){0,3}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(([0-9A-Fa-f]{1,4}:){1}(((:[0-9A-Fa-f]{1,4}){1,6})|((:[0-9A-Fa-f]{1,4}){0,4}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:))|(:(((:[0-9A-Fa-f]{1,4}){1,7})|((:[0-9A-Fa-f]{1,4}){0,5}:((25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(\\.(25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)){3}))|:)))(%.+)?\\s*$",
"type": "string"
},
"remoteServerMode": {
"description": "The mode in which the Remote Server operates.",
"enum": [
"Client",
"Server"
],
"type": "string"
}
},
"required": [
"localServerGroup",
"name",
"remoteServerMode"
],
"type": "object"
}
Example
{
"ipAddressPreference": "Ipv4",
"localServerGroup": [
"MP_SG_1",
"MP_SG_2"
],
"name": "mmiComagent1",
"remoteServerIPv4Address": "10.75.245.1",
"remoteServerMode": "Client"
}
delete /comagent/remoteservers/{name}
Deletes the specified Remote Server from the NOAM configuration. A Remote Server will only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
ComAgent: Routed Services
ComAgent Routed Service provides a means by which local applications hosted on an MP can send traffic to applications on other MPs. Routed Service has Connection Groups associated with the service assigned with different priorities. When an application sends events to other servers using a routed service, the ComAgent chooses a connection in the highest priority group for that routed service and sends the event on that connection.
/comagent/routedservices
get /comagent/routedservices
Returns all configured Routed Services and their associated connection groups configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Routed Services meeting the request parameters are returned in the response.
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/collections/routedserviceCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/routedservices/routedservice.json",
"properties": {
"connectionGroup": {
"description": "An array of Connection Group elements consisting of connection group name and priority values.",
"type": "array",
"items": {
"description": "Name and priority of connection group",
"properties": {
"name": {
"description": "Name of connection group",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"type": "string"
},
"priority": {
"description": "This is the priority of the Connection Group. When an application sends events to other servers using a routed service, the ComAgent chooses a connection in the highest priority group for that routed service and sends the event on that connection.",
"minimum": 0,
"maximum": 15,
"type": "integer"
}
},
"type": "object"
},
"minItems": 0,
"maxItems": 3
},
"name": {
"description": "The name of the Service within the system.",
"maxLength": 32,
"pattern": "^[a-zA-Z_][a-zA-Z0-9\\_]*$",
"readOnly": true,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"connectionGroup": [{
"name": "DPSvcGroup",
"priority": 10
}],
"name": "DPService"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/comagent/routedservices/status
get /comagent/routedservices/status
Returns the status of all routed service that meet the criteria specified in the request.
Target Server: SOAM and NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/collections/routedservicesstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id":"http://dsr.cgbu.oracle.com/schemas/comagent/routedservice/routedservicesstatus.json",
"properties":{
"totalProviderMP":{
"description":"Provider MP details of specific routed service.",
"items":{
"properties":{
"connectionGroups":{
"description":"Provider details.",
"items":{
"properties":{
"availableConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Available.",
"type":"integer"
},
"degradedConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Degraded.",
"type":"integer"
},
"totalConnGroup":{
"description":"Total number of providers in Connection Groups in the system.",
"type":"integer"
},
"unavailableConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Unavailable.",
"type":"integer"
}
},
"type":"object"
},
"maxItems": 4,
"minItems": 1,
"type":"array"
},
"totalMPs":{
"description":"Total number of providers in the system.",
"type":"integer"
}
},
"type":"object"
},
"type":"array"
},
"routedServiceName":{
"description":"Name of the Routed Service.",
"type":"string"
},
"user":{
"description":"User details of specific routed service.",
"items":{
"properties":{
"availableUserMP":{
"description":"Number of users that have routed service as Available.",
"type":"integer"
},
"degradedUserMP":{
"description":"Number of users that have routed service as Degraded.",
"type":"integer"
},
"totalUserMP":{
"description":"Total number of users in the system.",
"type":"integer"
},
"unavailableUserMP":{
"description":"Number of users that have routed service as Unavailable.",
"type":"integer"
}
},
"type":"object"
},
"maxItems": 4,
"minItems": 1,
"type":"array"
}
},
"type":"object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"totalProviderMP": {
"connectionGroups": {
"availableConnGroup": 1,
"degradedConnGroup": 0,
"totalConnGroup": 1,
"unavailableConnGroup": 0
}
},
"routedServiceName": "DSCEFSvc",
"user": {
"availableUserMP": 1,
"degradedUserMP": 0,
"totalUserMP": 1,
"unavailableUserMP": 0
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/comagent/routedservices/{name}/status
get /comagent/routedservices/{name}/status
Routed Service report provides status of the services on each server. We cand get summary or detailed report of it which can be saved in to file. The Summary view shows the number of connection groups used by a routed service. The Detailed view lists all servers in the connection group.
Target Server: SOAM and NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/routedservicesstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id":"http://dsr.cgbu.oracle.com/schemas/comagent/routedservice/routedservicesstatus.json",
"properties":{
"totalProviderMP":{
"description":"Provider MP details of specific routed service.",
"items":{
"properties":{
"connectionGroups":{
"description":"Provider details.",
"items":{
"properties":{
"availableConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Available.",
"type":"integer"
},
"degradedConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Degraded.",
"type":"integer"
},
"totalConnGroup":{
"description":"Total number of providers in Connection Groups in the system.",
"type":"integer"
},
"unavailableConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Unavailable.",
"type":"integer"
}
},
"type":"object"
},
"maxItems": 4,
"minItems": 1,
"type":"array"
},
"totalMPs":{
"description":"Total number of providers in the system.",
"type":"integer"
}
},
"type":"object"
},
"type":"array"
},
"routedServiceName":{
"description":"Name of the Routed Service.",
"type":"string"
},
"user":{
"description":"User details of specific routed service.",
"items":{
"properties":{
"availableUserMP":{
"description":"Number of users that have routed service as Available.",
"type":"integer"
},
"degradedUserMP":{
"description":"Number of users that have routed service as Degraded.",
"type":"integer"
},
"totalUserMP":{
"description":"Total number of users in the system.",
"type":"integer"
},
"unavailableUserMP":{
"description":"Number of users that have routed service as Unavailable.",
"type":"integer"
}
},
"type":"object"
},
"maxItems": 4,
"minItems": 1,
"type":"array"
}
},
"type":"object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"totalProviderMP": {
"connectionGroups": {
"availableConnGroup": 1,
"degradedConnGroup": 0,
"totalConnGroup": 1,
"unavailableConnGroup": 0
}
},
"routedServiceName": "DSCEFSvc",
"user": {
"availableUserMP": 1,
"degradedUserMP": 0,
"totalUserMP": 1,
"unavailableUserMP": 0
}
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/comagent/routedservices/{name}/congroup/{congroupname}/status
get /comagent/routedservices/{name}/congroup/{congroupname}/status
Retrieves the connection group for the specified Server.
Target server: SOAM and NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
- congroupname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/comagent/items/routedservicesstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id":"http://dsr.cgbu.oracle.com/schemas/comagent/routedservice/routedservicesstatus.json",
"properties":{
"totalProviderMP":{
"description":"Provider MP details of specific routed service.",
"items":{
"properties":{
"connectionGroups":{
"description":"Provider details.",
"items":{
"properties":{
"availableConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Available.",
"type":"integer"
},
"degradedConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Degraded.",
"type":"integer"
},
"totalConnGroup":{
"description":"Total number of providers in Connection Groups in the system.",
"type":"integer"
},
"unavailableConnGroup":{
"description":"Number of providers in Connection Groups that have routed service as Unavailable.",
"type":"integer"
}
},
"type":"object"
},
"maxItems": 4,
"minItems": 1,
"type":"array"
},
"totalMPs":{
"description":"Total number of providers in the system.",
"type":"integer"
}
},
"type":"object"
},
"type":"array"
},
"routedServiceName":{
"description":"Name of the Routed Service.",
"type":"string"
},
"user":{
"description":"User details of specific routed service.",
"items":{
"properties":{
"availableUserMP":{
"description":"Number of users that have routed service as Available.",
"type":"integer"
},
"degradedUserMP":{
"description":"Number of users that have routed service as Degraded.",
"type":"integer"
},
"totalUserMP":{
"description":"Total number of users in the system.",
"type":"integer"
},
"unavailableUserMP":{
"description":"Number of users that have routed service as Unavailable.",
"type":"integer"
}
},
"type":"object"
},
"maxItems": 4,
"minItems": 1,
"type":"array"
}
},
"type":"object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"totalProviderMP": {
"connectionGroups": {
"availableConnGroup": 1,
"degradedConnGroup": 0,
"totalConnGroup": 1,
"unavailableConnGroup": 0
}
},
"routedServiceName": "DSCEFSvc",
"user": {
"availableUserMP": 1,
"degradedUserMP": 0,
"totalUserMP": 1,
"unavailableUserMP": 0
}
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Common Security: Sfapp Neighboring Countries
A Sfapp Neighboring Countries is an entry which shows the record of an origin country with its mcc to neighboring country with its neighbor mcc.
All configuration of Sfapp Neighboring Countries is done at the SOAM.
/commonsecurity/neighboringcountries
get /commonsecurity/neighboringcountries
Returns all Sfapp Neighboring Countries that meet the criteria specified in the GET request. By default, all Sfapp Neighboring Countries configured at the SOAM are returned. If paging parameters are supplied, only those Sfapp Neighboring Countries record meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/collections/neighboringcountriesCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/neighboringcountries/neighboringcountries.json",
"properties": {
"mcc": {
"description": "The Mobile Country Code (MCC) is a three digit code that is used in combination with a Mobile Country Code (MCC) to identify a mobile network operator uniquely.",
"maximum": 999,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "The name of the origin country. Allowed characters are 1 alphabetic character followed by up to 49 alphabetic characters, including spaces.",
"maxLength": 50,
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"type": "string"
},
"neighMcc": {
"description": "The Mobile Country Code (MCC) is a three digit code that is used in combination with a Mobile Country Code (MCC) to identify a mobile network operator uniquely.",
"maximum": 999,
"minimum": 1,
"type": "integer"
},
"neighName": {
"description": "The name of the neighboring country. Allowed characters are 1 alphabetic character followed by up to 49 alphabetic characters, including spaces.",
"maxLength": 50,
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines an unique identifier for neigboring country. It is combination of mcc and neigh mcc.",
"readOnly": true,
"pattern": "^(([0-9]*)(-)([0-9]*))$",
"type": "string"
}
},
"required": [
"name",
"mcc",
"neighMcc",
"neighName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"mcc": 404,
"name": "India",
"neighMcc": 429,
"neighName": "Nepal"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /commonsecurity/neighboringcountries
Adds a new Sfapp Neighboring Countries record to the Sfapp configuration. The Sfapp Neighboring Countries record name must be unique across all Sfapp Neighboring Countries at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/neighboringcountries/neighboringcountries.json",
"properties": {
"mcc": {
"description": "The Mobile Country Code (MCC) is a three digit code that is used in combination with a Mobile Country Code (MCC) to identify a mobile network operator uniquely.",
"maximum": 999,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "The name of the origin country. Allowed characters are 1 alphabetic character followed by up to 49 alphabetic characters, including spaces.",
"maxLength": 50,
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"type": "string"
},
"neighMcc": {
"description": "The Mobile Country Code (MCC) is a three digit code that is used in combination with a Mobile Country Code (MCC) to identify a mobile network operator uniquely.",
"maximum": 999,
"minimum": 1,
"type": "integer"
},
"neighName": {
"description": "The name of the neighboring country. Allowed characters are 1 alphabetic character followed by up to 49 alphabetic characters, including spaces.",
"maxLength": 50,
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines an unique identifier for neigboring country. It is combination of mcc and neigh mcc.",
"readOnly": true,
"pattern": "^(([0-9]*)(-)([0-9]*))$",
"type": "string"
}
},
"required": [
"name",
"mcc",
"neighMcc",
"neighName"
],
"type": "object"
}
Example
{
"mcc": 404,
"name": "India",
"neighMcc": 429,
"neighName": "Nepal"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
delete /commonsecurity/neighboringcountries
Deletes the specified Sfapp Neighboring Countries record from the SOAM configuration. A Sfapp Neighboring Countries record can only be deleted if all delete validation checks pass. An attempt to delete a Sfapp Neighboring Countries record that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Common Security: MCC-CC-NDC Mapping
The Mapping provides the mapping between a Mobile country code and a Mobile network code for network identification.
All MccMnc mapping is done at the SOAM.
/commonsecurity/ccmccmappings
get /commonsecurity/ccmccmappings
Returns all MccMnc mapping configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those mapping data meeting the request parameters are returned in the response.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/collections/ccmccmappingCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/ccmccmapping/ccmccmapping.json",
"properties": {
"cc": {
"description": "Country codes are short alphabetic or numeric geographical codes (geocodes) developed to represent countries and dependent areas, for use in data processing and communications.",
"maximum":999,
"minimum":1,
"type": "integer"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"ndc": {
"description": "National Destination Code identifies the Number Plan Area that is to be used.",
"maximum":999,
"minimum":1,
"default":0,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAPPING. The unique identifier value is a combination of cc and ndc. This identifier is created and assigned by Sfapp. An example of a unique identifier is 994-0(when ndc is not specified), where 994 is cc and 0 is default value of ndc.",
"readOnly": true,
"type": "string"
}
},
"required": [
"cc",
"mcc"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"cc": 996,
"mcc": 435,
"ndc": 6
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /commonsecurity/ccmccmappings
Adds a new MccMnc mapping to the Common Security configuration. The Mapping combination shall not already exists in the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/ccmccmapping/ccmccmapping.json",
"properties": {
"cc": {
"description": "Country codes are short alphabetic or numeric geographical codes (geocodes) developed to represent countries and dependent areas, for use in data processing and communications.",
"maximum":999,
"minimum":1,
"type": "integer"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"ndc": {
"description": "National Destination Code identifies the Number Plan Area that is to be used.",
"maximum":999,
"minimum":1,
"default":0,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAPPING. The unique identifier value is a combination of cc and ndc. This identifier is created and assigned by Sfapp. An example of a unique identifier is 994-0(when ndc is not specified), where 994 is cc and 0 is default value of ndc.",
"readOnly": true,
"type": "string"
}
},
"required": [
"cc",
"mcc"
],
"type": "object"
}
Example
{
"cc": 996,
"mcc": 435,
"ndc": 6
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/commonsecurity/ccmccmappings/{uniqueIdentifier}
get /commonsecurity/ccmccmappings/{uniqueIdentifier}
Returns the configuration details for the specified MccMnc mapping data. If the specified MccMnc mapping does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/items/ccmccmappingItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/ccmccmapping/ccmccmapping.json",
"properties": {
"cc": {
"description": "Country codes are short alphabetic or numeric geographical codes (geocodes) developed to represent countries and dependent areas, for use in data processing and communications.",
"maximum":999,
"minimum":1,
"type": "integer"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"ndc": {
"description": "National Destination Code identifies the Number Plan Area that is to be used.",
"maximum":999,
"minimum":1,
"default":0,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAPPING. The unique identifier value is a combination of cc and ndc. This identifier is created and assigned by Sfapp. An example of a unique identifier is 994-0(when ndc is not specified), where 994 is cc and 0 is default value of ndc.",
"readOnly": true,
"type": "string"
}
},
"required": [
"cc",
"mcc"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"cc": 996,
"mcc": 435,
"ndc": 6
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /commonsecurity/ccmccmappings/{uniqueIdentifier}
Updates the configuration for the specified mapping. If the provided mapping data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/ccmccmapping/ccmccmapping.json",
"properties": {
"cc": {
"description": "Country codes are short alphabetic or numeric geographical codes (geocodes) developed to represent countries and dependent areas, for use in data processing and communications.",
"maximum":999,
"minimum":1,
"type": "integer"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"ndc": {
"description": "National Destination Code identifies the Number Plan Area that is to be used.",
"maximum":999,
"minimum":1,
"default":0,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAPPING. The unique identifier value is a combination of cc and ndc. This identifier is created and assigned by Sfapp. An example of a unique identifier is 994-0(when ndc is not specified), where 994 is cc and 0 is default value of ndc.",
"readOnly": true,
"type": "string"
}
},
"required": [
"cc",
"mcc"
],
"type": "object"
}
Example
{
"cc": 996,
"mcc": 435,
"ndc": 6
}
delete /commonsecurity/ccmccmappings/{uniqueIdentifier}
Deletes the specified mapped data from the SOAM configuration. A mapped data will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Common Security: Country Latitude Longitude
A Country Latitude and Longitude is an entry which shows the record of an origin country with its latitude and longitude..
All Country Latitude Longitude is done at the SOAM.
/commonsecurity/countrylonglats
get /commonsecurity/countrylonglats
Returns all Country configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those data meeting the request parameters are returned in the response.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/collections/countrylonglatCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/countrylonglat/countrylonglat.json",
"properties": {
"latitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"longitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"countryName": {
"description": "Country Name, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"maxLength": 50,
"type": "string"
}
},
"required": [
"latitude",
"longitude",
"countryName",
"mcc"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"latitude":"37\"58'N",
"longitude":"23\"46'E",
"mcc":262,
"CountryName":"Greece"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /commonsecurity/countrylonglats
Adds a new Country to the Common Security configuration. The country shall not already exists in the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/countrylonglat/countrylonglat.json",
"properties": {
"latitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"longitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"countryName": {
"description": "Country Name, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"maxLength": 50,
"type": "string"
}
},
"required": [
"latitude",
"longitude",
"countryName",
"mcc"
],
"type": "object"
}
Example
{
"latitude":"37\"58'N",
"longitude":"23\"46'E",
"mcc":262,
"CountryName":"Greece"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/commonsecurity/countrylonglats/{uniqueIdentifier}
get /commonsecurity/countrylonglats/{uniqueIdentifier}
Returns the configuration details for the specified Country. If the specified Country does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/commonsecurity/items/countrylonglatItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/countrylonglat/countrylonglat.json",
"properties": {
"latitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"longitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"countryName": {
"description": "Country Name, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"maxLength": 50,
"type": "string"
}
},
"required": [
"latitude",
"longitude",
"countryName",
"mcc"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"latitude":"37\"58'N",
"longitude":"23\"46'E",
"mcc":262,
"CountryName":"Greece"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /commonsecurity/countrylonglats/{uniqueIdentifier}
Updates the configuration for the specified country. If the provided country data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/countrylonglat/countrylonglat.json",
"properties": {
"latitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"longitude": {
"description": "This defines the longitude of country.In Get operation the value will be accurate only upto one digit after decimal.",
"pattern":"^[0-9]*\\.?[0-9]*\\s[a-zA-Z]$",
"maxLength": 10,
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maximum":999,
"minimum":1,
"type": "integer"
},
"countryName": {
"description": "Country Name, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"pattern": "^[A-Za-z][a-zA-Z-0-9 ]*",
"maxLength": 50,
"type": "string"
}
},
"required": [
"latitude",
"longitude",
"countryName",
"mcc"
],
"type": "object"
}
Example
{
"latitude":"37\"58'N",
"longitude":"23\"46'E",
"mcc":262,
"CountryName":"Greece"
}
delete /commonsecurity/countrylonglats/{uniqueIdentifier}
Deletes the specified mapped data from the SOAM configuration. A mapped data will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Diameter: Application Ids
An Application Id is an identification number used to identify a Diameter application on the DSR. Application Ids, and associated Application Names, can be retrieved, deleted, and assigned. An Application Id value cannot be changed, but the Application Name can be changed.
Standard Application Ids range from 0 to 16777215; Vendor-specific Application Ids range from 16777216 to 4194967294; and Relay is assigned 4294967295. The maximum number of Ids that can be assigned is 1000.
All Application Id configuration is done at the SOAM.
/diameter/applicationids
get /diameter/applicationids
Returns all Application Ids configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Application Ids meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/applicationidCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationid/applicationid.json",
"properties": {
"appId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Application Id.",
"maxLength": 32,
"pattern": "^(([0-9_][A-Za-z0-9_ \\+\\-\\*\\(\\)]*[A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*)|([A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*))$",
"type": "string"
}
},
"required": [
"appId",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"appId": 4294967295,
"configurationLevel": "0",
"name": "Relay"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/applicationids
Adds a new Application Id to the DSR configuration. The new Application Id must be unique and have an associated Application Name.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationid/applicationid.json",
"properties": {
"appId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Application Id.",
"maxLength": 32,
"pattern": "^(([0-9_][A-Za-z0-9_ \\+\\-\\*\\(\\)]*[A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*)|([A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*))$",
"type": "string"
}
},
"required": [
"appId",
"name"
],
"type": "object"
}
Example
{
"appId": 4294967295,
"configurationLevel": "0",
"name": "Relay"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/applicationids/{appId}
get /diameter/applicationids/{appId}
Returns the configuration details for the specified Application Id. If the specified Application Id does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- appId: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/applicationidItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationid/applicationid.json",
"properties": {
"appId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Application Id.",
"maxLength": 32,
"pattern": "^(([0-9_][A-Za-z0-9_ \\+\\-\\*\\(\\)]*[A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*)|([A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*))$",
"type": "string"
}
},
"required": [
"appId",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"appId": 4294967295,
"configurationLevel": "0",
"name": "Relay"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/applicationids/{appId}
Updates the associated Application Name for the Application Id.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- appId: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationid/applicationid.json",
"properties": {
"appId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Application Id.",
"maxLength": 32,
"pattern": "^(([0-9_][A-Za-z0-9_ \\+\\-\\*\\(\\)]*[A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*)|([A-Za-z][A-Za-z0-9_ \\+\\-\\*\\(\\)]*))$",
"type": "string"
}
},
"required": [
"appId",
"name"
],
"type": "object"
}
Example
{
"appId": 4294967295,
"configurationLevel": "0",
"name": "Relay"
}
delete /diameter/applicationids/{appId}
Deletes the specified Application Id from the SOAM configuration. An Application ID can only be deleted if all delete validation checks pass. In general, if the Application Id is part of the configuration of some other Managed Object, the Application Id cannot be deleted. For example, if the Application Id is named by a Peer Route Table (/diameter/peerroutetables), the Application Id must first be removed from the Peer Route Table. Then the Application Id can be deleted from the configuration. An attempt to delete an Application Id that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- appId: required (string)
Diameter: Application Priority Options
An ApplicationPriorityOption has been added to support DRMP on a per Diameter ApplicationID basis. It only allows a user to configure priorities for those ApplicationID which already exists on SOAM.
All ApplicationPriorityOption configuration is done at the SOAM.
/diameter/applicationpriorityoptions
get /diameter/applicationpriorityoptions
Returns all ApplicationPriorityOption configured for specific ApplicationID at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Application Priority Option meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/applicationpriorityoptionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationpriorityoption/applicationpriorityoption.json",
"properties": {
"answerDrmpAvpAdminStateEnabled": {
"description": "When set to true, the DRMP AVP in the Answer message is used to assign the Answer priority for messages having Application Id equal to the appId attribute value. The typical value is false. answerDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
},
"appId": {
"description": "The value for appId must be that of an Application Id already configured at this SOAM.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"ngnPsDrmpAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on DRMP AVP is enabled for this Application Id. The typical value is false. ngnPsDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) and ngnPs16PriorityAdminStateEnabled value (/diameter/options) are set to true.",
"type": "boolean"
},
"ngnPs3gppAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on 3GPP AVP's is enabled for this Application Id. The typical value is false. ngnPs3gppAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true and appId attribute value is set to 16777216, 16777217, 16777236 or 16777238.",
"type": "boolean"
},
"requestDrmpAvpAdminStateEnabled": {
"description": "When set to true, DRMP AVP in Request message is used to assign Request priority for this Application Id. The typical value is false. requestDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
}
},
"required": [
"appId"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"answerDrmpAvpAdminStateEnabled" : false,
"appId" : 16777216,
"configurationLevel": "0",
"ngnPsDrmpAvpAdminStateEnabled": false,
"ngnPs3gppAvpAdminStateEnabled": false,
"requestDrmpAvpAdminStateEnabled": false
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/applicationpriorityoptions
Adds a new ApplicationPriorityOption for the existing ApplicationID to the DSR configuration. The selected ApplicationID must be unique and have an associated Application Name.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationpriorityoption/applicationpriorityoption.json",
"properties": {
"answerDrmpAvpAdminStateEnabled": {
"description": "When set to true, the DRMP AVP in the Answer message is used to assign the Answer priority for messages having Application Id equal to the appId attribute value. The typical value is false. answerDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
},
"appId": {
"description": "The value for appId must be that of an Application Id already configured at this SOAM.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"ngnPsDrmpAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on DRMP AVP is enabled for this Application Id. The typical value is false. ngnPsDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) and ngnPs16PriorityAdminStateEnabled value (/diameter/options) are set to true.",
"type": "boolean"
},
"ngnPs3gppAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on 3GPP AVP's is enabled for this Application Id. The typical value is false. ngnPs3gppAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true and appId attribute value is set to 16777216, 16777217, 16777236 or 16777238.",
"type": "boolean"
},
"requestDrmpAvpAdminStateEnabled": {
"description": "When set to true, DRMP AVP in Request message is used to assign Request priority for this Application Id. The typical value is false. requestDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
}
},
"required": [
"appId"
],
"type": "object"
}
Example
{
"answerDrmpAvpAdminStateEnabled" : false,
"appId" : 16777216,
"configurationLevel": "0",
"ngnPsDrmpAvpAdminStateEnabled": false,
"ngnPs3gppAvpAdminStateEnabled": false,
"requestDrmpAvpAdminStateEnabled": false
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/applicationpriorityoptions/{appId}
get /diameter/applicationpriorityoptions/{appId}
Returns the configuration details for the specified Application Id from ApplicationPriorityOption. If the specified Application Id does not exist in ApplicationPriorityOption at SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- appId: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/applicationpriorityoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationpriorityoption/applicationpriorityoption.json",
"properties": {
"answerDrmpAvpAdminStateEnabled": {
"description": "When set to true, the DRMP AVP in the Answer message is used to assign the Answer priority for messages having Application Id equal to the appId attribute value. The typical value is false. answerDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
},
"appId": {
"description": "The value for appId must be that of an Application Id already configured at this SOAM.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"ngnPsDrmpAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on DRMP AVP is enabled for this Application Id. The typical value is false. ngnPsDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) and ngnPs16PriorityAdminStateEnabled value (/diameter/options) are set to true.",
"type": "boolean"
},
"ngnPs3gppAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on 3GPP AVP's is enabled for this Application Id. The typical value is false. ngnPs3gppAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true and appId attribute value is set to 16777216, 16777217, 16777236 or 16777238.",
"type": "boolean"
},
"requestDrmpAvpAdminStateEnabled": {
"description": "When set to true, DRMP AVP in Request message is used to assign Request priority for this Application Id. The typical value is false. requestDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
}
},
"required": [
"appId"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"answerDrmpAvpAdminStateEnabled" : false,
"appId" : 16777216,
"configurationLevel": "0",
"ngnPsDrmpAvpAdminStateEnabled": false,
"ngnPs3gppAvpAdminStateEnabled": false,
"requestDrmpAvpAdminStateEnabled": false
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/applicationpriorityoptions/{appId}
Updates the associated attrubutes(ReqDRMPAVPAdminState, AnsDRMPAVPAdminState, NgnPs3gppAVPAdminState, NgnPsDRMPAVPAdminState) for the Application Id.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- appId: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationpriorityoption/applicationpriorityoption.json",
"properties": {
"answerDrmpAvpAdminStateEnabled": {
"description": "When set to true, the DRMP AVP in the Answer message is used to assign the Answer priority for messages having Application Id equal to the appId attribute value. The typical value is false. answerDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
},
"appId": {
"description": "The value for appId must be that of an Application Id already configured at this SOAM.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"ngnPsDrmpAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on DRMP AVP is enabled for this Application Id. The typical value is false. ngnPsDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) and ngnPs16PriorityAdminStateEnabled value (/diameter/options) are set to true.",
"type": "boolean"
},
"ngnPs3gppAvpAdminStateEnabled": {
"description": "When set to true, the NGN-PS tagging based on 3GPP AVP's is enabled for this Application Id. The typical value is false. ngnPs3gppAvpAdminStateEnabled only affects the behavior of the DSR when ngnPsAdminStateEnabled value (/diameter/options) is set to true and appId attribute value is set to 16777216, 16777217, 16777236 or 16777238.",
"type": "boolean"
},
"requestDrmpAvpAdminStateEnabled": {
"description": "When set to true, DRMP AVP in Request message is used to assign Request priority for this Application Id. The typical value is false. requestDrmpAvpAdminStateEnabled only affects the behavior of the DSR when ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true.",
"type": "boolean"
}
},
"required": [
"appId"
],
"type": "object"
}
Example
{
"answerDrmpAvpAdminStateEnabled" : false,
"appId" : 16777216,
"configurationLevel": "0",
"ngnPsDrmpAvpAdminStateEnabled": false,
"ngnPs3gppAvpAdminStateEnabled": false,
"requestDrmpAvpAdminStateEnabled": false
}
delete /diameter/applicationpriorityoptions/{appId}
Deletes the specified Application Id from the ApplicationPriorityOption at SOAM configuration. An Application ID can only be deleted if all delete validation checks pass. In general, if the Application Id is part of the configuration of some other Managed Object, the Application Id cannot be deleted. An attempt to delete an Application Id that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- appId: required (string)
Diameter: Application Route Rules
Application Route Rules are individual rules that specify how ingress request messages are routed by the DSR. Each Application Route Rule is associated with exactly one Application Route Table (/diameter/applicationroutetables). Whenever a request message is processed by the DSR, one of the configured Application Route Tables is selected (based on the DSR's general routing behavior, tailored by the DSR's specific configuration), and then the Application Route Rules owned by the selected Application Route Table are evaluated to see which Rule is applied to the request message. All Application Route Rules associated with an Application Route Table form the prioritized set of rules against which the request message is compared. The request is then routed based on the configuration of the selected Rule.
Each Application Route Rule specifies criteria, called conditions, against which the request message is compared. Each Rule also has a defined priority. The action taken by the DSR in response to the request message is based on the highest-priority Application Route Rule whose conditions match the request message information. The possible actions are: route to an Application, which occurs when the request conditions match the the Rules; forward to a Peer Node (/diameter/peernodes); send an answer message to the ingress Application that transmitted the request message; or abandon the request message.
All Application Route Rule configuration is done at the SOAM.
/diameter/applicationrouterules
get /diameter/applicationrouterules
Returns all Application Route Rules configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Application Route Rules meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/applicationrouteruleCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationrouterule/applicationrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToAppl, DSR routes the message to the DSR Application specified in the Rule. When set to ForwardToEgressRouting, DSR chooses a PRT and routes, answers, or abandons the message based on the current DSR routing configuration (depending on whether or not the message matches any rule in the selected PRT). When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the ansResultCode value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node (/diameter/peernodes). When set to ForwardToArt, DSR routes the message to the Application Route Table (/diameter/applicationroutetables) for further processing. When set to ForwardToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"ForwardToArt",
"ForwardToEgressRouting",
"ForwardToPrt",
"RouteToAppl",
"SendAnswer"
],
"type": "string"
},
"ansErrorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"ansResultCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"appName": {
"description": "Name for the DSR Application associated with this rule.",
"maxLength": 32,
"type": "string"
},
"appRouteTableName": {
"description": "The name of the Application Route Table (/diameter/applicationroutetables) to which this Application Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Application Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"forwardToTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Application Route Rule's action value is ForwardToArt or ForwardToPrt.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"gxPrimeRequest": {
"description": "If true, and if this Rule matches a request, PCA treats the request's Diameter Application as Gx-Prime.",
"type": "boolean"
},
"name": {
"description": "Name for the Application Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Application Route Table (/diameter/applicationroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"appRouteTableName",
"conditions",
"gxPrimeRequest",
"name",
"priority"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action": "SendAnswer",
"ansErrorMessage": "ErrorMessage",
"ansResultCode": 2000,
"appRouteTableName": "Default",
"conditions":
{
"appId":
{
"operator": "DontCare"
} ,
"cmdCode":
{
"operator": "Equal",
"value": "1"
},
"destHost":
{
"operator": "EndsWith",
"value": "domain.com"
},
"destRealm":
{
"operator": "EndsWith",
"value": "domain.com"
},
"origHost":
{
"operator": "DontCare"
},
"origRealm":
{
"operator": "NotEqual",
"value": "dp.domain.com"
}
},
"configurationLevel": "45",
"gxPrimeRequest": false,
"name": "ApplicationRouteRule_31",
"priority": 999,
"vendorId": 30
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/applicationrouterules
Adds a new Application Route Rule to the specified Application Route Table (/diameter/applicationroutetables). Even though an Application Route Rule is owned by a single Application Route Table, each Application Route Rule must have a name unique across all Application Route Tables configured at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationrouterule/applicationrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToAppl, DSR routes the message to the DSR Application specified in the Rule. When set to ForwardToEgressRouting, DSR chooses a PRT and routes, answers, or abandons the message based on the current DSR routing configuration (depending on whether or not the message matches any rule in the selected PRT). When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the ansResultCode value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node (/diameter/peernodes). When set to ForwardToArt, DSR routes the message to the Application Route Table (/diameter/applicationroutetables) for further processing. When set to ForwardToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"ForwardToArt",
"ForwardToEgressRouting",
"ForwardToPrt",
"RouteToAppl",
"SendAnswer"
],
"type": "string"
},
"ansErrorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"ansResultCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"appName": {
"description": "Name for the DSR Application associated with this rule.",
"maxLength": 32,
"type": "string"
},
"appRouteTableName": {
"description": "The name of the Application Route Table (/diameter/applicationroutetables) to which this Application Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Application Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"forwardToTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Application Route Rule's action value is ForwardToArt or ForwardToPrt.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"gxPrimeRequest": {
"description": "If true, and if this Rule matches a request, PCA treats the request's Diameter Application as Gx-Prime.",
"type": "boolean"
},
"name": {
"description": "Name for the Application Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Application Route Table (/diameter/applicationroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"appRouteTableName",
"conditions",
"gxPrimeRequest",
"name",
"priority"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"ansErrorMessage": "ErrorMessage",
"ansResultCode": 2000,
"appRouteTableName": "Default",
"conditions":
{
"appId":
{
"operator": "DontCare"
} ,
"cmdCode":
{
"operator": "Equal",
"value": "1"
},
"destHost":
{
"operator": "EndsWith",
"value": "domain.com"
},
"destRealm":
{
"operator": "EndsWith",
"value": "domain.com"
},
"origHost":
{
"operator": "DontCare"
},
"origRealm":
{
"operator": "NotEqual",
"value": "dp.domain.com"
}
},
"configurationLevel": "45",
"gxPrimeRequest": false,
"name": "ApplicationRouteRule_31",
"priority": 999,
"vendorId": 30
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/applicationrouterules/{name}
get /diameter/applicationrouterules/{name}
Returns the configuration details for the specified Application Route Rule. If the specified Application Route Rule does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/applicationrouteruleItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationrouterule/applicationrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToAppl, DSR routes the message to the DSR Application specified in the Rule. When set to ForwardToEgressRouting, DSR chooses a PRT and routes, answers, or abandons the message based on the current DSR routing configuration (depending on whether or not the message matches any rule in the selected PRT). When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the ansResultCode value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node (/diameter/peernodes). When set to ForwardToArt, DSR routes the message to the Application Route Table (/diameter/applicationroutetables) for further processing. When set to ForwardToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"ForwardToArt",
"ForwardToEgressRouting",
"ForwardToPrt",
"RouteToAppl",
"SendAnswer"
],
"type": "string"
},
"ansErrorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"ansResultCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"appName": {
"description": "Name for the DSR Application associated with this rule.",
"maxLength": 32,
"type": "string"
},
"appRouteTableName": {
"description": "The name of the Application Route Table (/diameter/applicationroutetables) to which this Application Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Application Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"forwardToTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Application Route Rule's action value is ForwardToArt or ForwardToPrt.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"gxPrimeRequest": {
"description": "If true, and if this Rule matches a request, PCA treats the request's Diameter Application as Gx-Prime.",
"type": "boolean"
},
"name": {
"description": "Name for the Application Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Application Route Table (/diameter/applicationroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"appRouteTableName",
"conditions",
"gxPrimeRequest",
"name",
"priority"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action": "SendAnswer",
"ansErrorMessage": "ErrorMessage",
"ansResultCode": 2000,
"appRouteTableName": "Default",
"conditions":
{
"appId":
{
"operator": "DontCare"
} ,
"cmdCode":
{
"operator": "Equal",
"value": "1"
},
"destHost":
{
"operator": "EndsWith",
"value": "domain.com"
},
"destRealm":
{
"operator": "EndsWith",
"value": "domain.com"
},
"origHost":
{
"operator": "DontCare"
},
"origRealm":
{
"operator": "NotEqual",
"value": "dp.domain.com"
}
},
"configurationLevel": "45",
"gxPrimeRequest": false,
"name": "ApplicationRouteRule_31",
"priority": 999,
"vendorId": 30
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/applicationrouterules/{name}
Updates the configuration for the specified Application Route Rule. If the provided Application Route Rule data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationrouterule/applicationrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToAppl, DSR routes the message to the DSR Application specified in the Rule. When set to ForwardToEgressRouting, DSR chooses a PRT and routes, answers, or abandons the message based on the current DSR routing configuration (depending on whether or not the message matches any rule in the selected PRT). When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the ansResultCode value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node (/diameter/peernodes). When set to ForwardToArt, DSR routes the message to the Application Route Table (/diameter/applicationroutetables) for further processing. When set to ForwardToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"ForwardToArt",
"ForwardToEgressRouting",
"ForwardToPrt",
"RouteToAppl",
"SendAnswer"
],
"type": "string"
},
"ansErrorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"ansResultCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"appName": {
"description": "Name for the DSR Application associated with this rule.",
"maxLength": 32,
"type": "string"
},
"appRouteTableName": {
"description": "The name of the Application Route Table (/diameter/applicationroutetables) to which this Application Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Application Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"forwardToTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Application Route Rule's action value is ForwardToArt or ForwardToPrt.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"gxPrimeRequest": {
"description": "If true, and if this Rule matches a request, PCA treats the request's Diameter Application as Gx-Prime.",
"type": "boolean"
},
"name": {
"description": "Name for the Application Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Application Route Table (/diameter/applicationroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"appRouteTableName",
"conditions",
"gxPrimeRequest",
"name",
"priority"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"ansErrorMessage": "ErrorMessage",
"ansResultCode": 2000,
"appRouteTableName": "Default",
"conditions":
{
"appId":
{
"operator": "DontCare"
} ,
"cmdCode":
{
"operator": "Equal",
"value": "1"
},
"destHost":
{
"operator": "EndsWith",
"value": "domain.com"
},
"destRealm":
{
"operator": "EndsWith",
"value": "domain.com"
},
"origHost":
{
"operator": "DontCare"
},
"origRealm":
{
"operator": "NotEqual",
"value": "dp.domain.com"
}
},
"configurationLevel": "45",
"gxPrimeRequest": false,
"name": "ApplicationRouteRule_31",
"priority": 999,
"vendorId": 30
}
delete /diameter/applicationrouterules/{name}
Deletes the specified Application Route Rule from the SOAM configuration. An Application Route Rule can always be deleted - there are no validation checks when deleting a Rule.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Application Route Tables
An Application Route Table (ART) is a collection of prioritized Application Route Rules the DSR searches to determine how to route a Diameter request message to a specific DSR Application. An SOAM can be configured with multiple ARTs, which each cover a partial, yet distinct, subset of routing scenarios. The number and content of ARTs configured at an SOAM depends entirely on the DSR's required role within the larger Diameter network.
A given ART can be associated with a Peer Node or with a Transaction Configuration Set.
Request messages received by the DSR are compared against the Application Route Rules within the applicable ART. The action taken by the DSR in response to the request message is based on the highest-priority Application Route Rule that matches the request message information. The possible actions are: route a message to a DSR Application associated with the rule; forward to egress routing, which forwards the message to the Peer Route Table to route to a Peer; send an answer message to the Peer that originated the Diameter request message; or abandon the message routing without sending an answer response.
All Application Route Table configuration is done at the SOAM.
/diameter/applicationroutetables
get /diameter/applicationroutetables
Returns all Application Route Tables configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Application Route Tables meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/applicationroutetableCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationroutetable/applicationroutetable.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Application Route Table, which must be unique within the DSR site. A name is required, and cannot be changed after the ART is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "202",
"name": "appRouteTable1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/applicationroutetables
Adds a new Application Route Table to the DSR configuration. The new ART must have a name unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationroutetable/applicationroutetable.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Application Route Table, which must be unique within the DSR site. A name is required, and cannot be changed after the ART is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "202",
"name": "appRouteTable1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/applicationroutetables/{name}
get /diameter/applicationroutetables/{name}
Returns the configuration details for the specified ART. If the specified ART does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/applicationroutetableItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationroutetable/applicationroutetable.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Application Route Table, which must be unique within the DSR site. A name is required, and cannot be changed after the ART is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "202",
"name": "appRouteTable1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /diameter/applicationroutetables/{name}
Deletes the specified Application Route Table from the SOAM configuration. An ART is only deleted if all delete validation checks pass. If the ART is associated with the configuration of a Peer Node or Transaction Configuration Set, the ART cannot be deleted. For example, if the ART is associated with a Peer Node (/diameter/peernodes), that association must first be removed (either by editing the Peer Node and choosing a different ART, or deleting the Peer Node entirely). Then the ART can be deleted from the configuration. An attempt to delete an ART that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Applications
The Application feature allows to view state and congestion information about existing diameter applications and can enable and disable diameter applications.
All Applications are enabled or disabled only on the MP server.
/diameter/applications/status
get /diameter/applications/status
Returns the status of all Applications that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data (except statusKnown - this attribute cannot be filtered). Attributes can be filtered using EQUAL, NOT_EQUAL, LIKE.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE.
Example:
filter_name=applicationName
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=FABR
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/applicationstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/application/applicationstatus.json",
"properties": {
"appAdminState": {
"description": "The administrative state defines whether the Application is active and can be utilized on the MP Server for which status is reported.",
"enum": [
"Disabled",
"Enabled"
],
"type": "string"
},
"applicationName": {
"description": "Name of the Application.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"appTimeOfLastUpdate": {
"description": "The date/time of the status for this specific Application was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"readOnly": true,
"type": "string"
},
"congestionLevel": {
"description": "Tells application congestion level.",
"enum": [
"Normal",
"CL1",
"CL2",
"CL3",
"CL98",
"CL99"
],
"readOnly": true,
"type": "string"
},
"mpServerName": {
"description": "Hostname of MP server from which status is reported. For the Application status:In case of Multiple Active DA-MP configuration, the MP Leader always reports the Application status and in case of Active/Standby DA-MP configuration, the Active DA-MP reports the Application status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
},
"operationalReason": {
"description": "Reason for the each Application Operational Status.",
"maxLength": 32,
"readOnly": true,
"type": "string"
},
"operationalStatus": {
"description": "Tells application operational status. When Available is specified, at least one Application is available for routing. When Degraded is specified, the Application is not unavailable but it is not operating as expected. When Unavailable is specified all Application are unavailable. The Operational Reason field provides additional information Degraded and Unavailable status..",
"enum": [
"Available",
"Degraded",
"Unavailable"
],
"readOnly": true,
"default": "Available",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Application are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Application. If the OAM has current status for this Application, statusKnown is set to true.",
"readOnly": true,
"type": "boolean"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"appAdminState": "Enabled",
"applicationName": "SCEF",
"appTimeOfLastUpdate": "2018-Apr-03 11:05:05 EDT",
"congestionLevel": "Normal",
"mpServerName": "DsrMP1",
"operationalReason": "Normal",
"operationalStatus": "Available",
"statusKnown": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/applications/{applicationName}/applicationadminstate
get /diameter/applications/{applicationName}/applicationadminstate
Retrieves the administrative state for the specified Application, which can be Enabled or Disabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- applicationName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/applicationadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationadminstate/applicationadminstate.json",
"properties": {
"appAdminState": {
"description": "The administrative state defines whether the Application is active and can be utilized on the MP Serverfor which status is reported.",
"enum": [
"Disabled",
"Enabled"
],
"type": "string"
},
"mpServerName": {
"description": "Hostname of MP server from which status is reported. For the Application status:In case of Multiple Active DA-MP configuration, the MP Leader always reports the Application status and in case of Active/Standby DA-MP configuration, the Active DA-MP reports the Application status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
}
},
"required": [
"appAdminState",
"mpServerName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"appAdminState": "Enabled",
"mpServerName": "DsrSite00DAMP01"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/applications/{applicationName}/applicationadminstate
Updates the administrative state for the specified Application to either Enabled or Disabled.
An Application can be enabled or disabled only on the MP server.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- applicationName: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/applicationadminstate/applicationadminstate.json",
"properties": {
"appAdminState": {
"description": "The administrative state defines whether the Application is active and can be utilized on the MP Serverfor which status is reported.",
"enum": [
"Disabled",
"Enabled"
],
"type": "string"
},
"mpServerName": {
"description": "Hostname of MP server from which status is reported. For the Application status:In case of Multiple Active DA-MP configuration, the MP Leader always reports the Application status and in case of Active/Standby DA-MP configuration, the Active DA-MP reports the Application status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
}
},
"required": [
"appAdminState",
"mpServerName"
],
"type": "object"
}
Example
{
"appAdminState": "Enabled",
"mpServerName": "DsrSite00DAMP01"
}
Diameter: AVP Removal Lists
An AVP Removal List is used to selectively remove AVPs from Diameter messages, and it is associated with a Peer Node (/diameter/peernodes) through Peer Node configuration. Any AVP can be removed using this mechanism, but one potential use case is the removal of vendor-specific AVPs.
AVPs can be removed from within the body of Diameter messages: 1) ingressing the DSR; 2) egressing the DSR; or 3) both. In addition, an AVP Removal List can be applied to just request messages, just answer messages, or both request and answer messages. Up to ten AVPs can be specified in an AVP Removal List, and all AVPs in the list that are found within a message to be processed are removed from that message.
All AVP Removal List configuration is done at the SOAM.
/diameter/avpremovallists
get /diameter/avpremovallists
Returns all AVP Removal Lists configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those AVP Removal Lists meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/avpremovallistCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/avpremovallist/avpremovallist.json",
"properties": {
"avp": {
"description": "The AVPs associated with this AVP Removal List. An AVP Removal List must have between one and ten AVPs in the list.",
"items": {
"properties": {
"avpCode": {
"description": "The 32-bit number that, when combined with the vendorId value, uniquely identifies the Diameter attribute.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"avpName": {
"description": "User-defined name associated with this avpCode. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
},
"vendorId": {
"description": "The 32-bit number that identifies the vendor for vendor-specific AVPs. If the avpCode is not vendor-specific, the vendorId field should be zero.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"vendorName": {
"description": "User-defined name associated with the vendorId value. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
}
},
"required": [
"avpCode",
"vendorId"
],
"type": "object"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"direction": {
"description": "When set to Ingress, only messages (request or answer) entering the DSR can be stripped of the AVPs in the list. When set to Egress, AVPs can only be removed from messages exiting the DSR. When set to IngressAndEgress, AVPs can be removed from both ingress and egress messages.",
"enum": [
"Egress",
"Ingress",
"IngressAndEgress"
],
"type": "string"
},
"messageType": {
"description": "When set to RequestOnly, AVPs can be removed only from request messages. When set to AnswerOnly, AVPs can be removed only from answer messages. When set to RequestAndAnswer, AVPs can be removed from both request and answer messages.",
"enum": [
"AnswerOnly",
"RequestAndAnswer",
"RequestOnly"
],
"type": "string"
},
"name": {
"description": "Name for this AVP Removal List, which must be unique within the DSR site. A name is required, and cannot be changed after the AVP Removal List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"avp",
"direction",
"messageType",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"avp": [
{
"avpCode": 1000,
"avpName": "testAVP",
"vendorId": 4242,
"vendorName": "testVendor"
},
{
"avpCode": 2000,
"avpName": "testAVP2",
"vendorId": 908,
"vendorName": "testVendor2"
}
],
"configurationLevel": "8675309",
"direction": "Ingress",
"messageType": "RequestAndAnswer",
"name": "AvpRemovalList1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/avpremovallists
Adds a new AVP Removal List to the DSR configuration. The new AVP Removal List must have a name that is unique across all AVP Removal Lists at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/avpremovallist/avpremovallist.json",
"properties": {
"avp": {
"description": "The AVPs associated with this AVP Removal List. An AVP Removal List must have between one and ten AVPs in the list.",
"items": {
"properties": {
"avpCode": {
"description": "The 32-bit number that, when combined with the vendorId value, uniquely identifies the Diameter attribute.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"avpName": {
"description": "User-defined name associated with this avpCode. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
},
"vendorId": {
"description": "The 32-bit number that identifies the vendor for vendor-specific AVPs. If the avpCode is not vendor-specific, the vendorId field should be zero.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"vendorName": {
"description": "User-defined name associated with the vendorId value. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
}
},
"required": [
"avpCode",
"vendorId"
],
"type": "object"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"direction": {
"description": "When set to Ingress, only messages (request or answer) entering the DSR can be stripped of the AVPs in the list. When set to Egress, AVPs can only be removed from messages exiting the DSR. When set to IngressAndEgress, AVPs can be removed from both ingress and egress messages.",
"enum": [
"Egress",
"Ingress",
"IngressAndEgress"
],
"type": "string"
},
"messageType": {
"description": "When set to RequestOnly, AVPs can be removed only from request messages. When set to AnswerOnly, AVPs can be removed only from answer messages. When set to RequestAndAnswer, AVPs can be removed from both request and answer messages.",
"enum": [
"AnswerOnly",
"RequestAndAnswer",
"RequestOnly"
],
"type": "string"
},
"name": {
"description": "Name for this AVP Removal List, which must be unique within the DSR site. A name is required, and cannot be changed after the AVP Removal List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"avp",
"direction",
"messageType",
"name"
],
"type": "object"
}
Example
{
"avp": [
{
"avpCode": 1000,
"avpName": "testAVP",
"vendorId": 4242,
"vendorName": "testVendor"
},
{
"avpCode": 2000,
"avpName": "testAVP2",
"vendorId": 908,
"vendorName": "testVendor2"
}
],
"configurationLevel": "8675309",
"direction": "Ingress",
"messageType": "RequestAndAnswer",
"name": "AvpRemovalList1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/avpremovallists/{name}
get /diameter/avpremovallists/{name}
Returns the configuration details for the specified AVP Removal List. If the specified AVP Removal List does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/avpremovallistItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/avpremovallist/avpremovallist.json",
"properties": {
"avp": {
"description": "The AVPs associated with this AVP Removal List. An AVP Removal List must have between one and ten AVPs in the list.",
"items": {
"properties": {
"avpCode": {
"description": "The 32-bit number that, when combined with the vendorId value, uniquely identifies the Diameter attribute.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"avpName": {
"description": "User-defined name associated with this avpCode. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
},
"vendorId": {
"description": "The 32-bit number that identifies the vendor for vendor-specific AVPs. If the avpCode is not vendor-specific, the vendorId field should be zero.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"vendorName": {
"description": "User-defined name associated with the vendorId value. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
}
},
"required": [
"avpCode",
"vendorId"
],
"type": "object"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"direction": {
"description": "When set to Ingress, only messages (request or answer) entering the DSR can be stripped of the AVPs in the list. When set to Egress, AVPs can only be removed from messages exiting the DSR. When set to IngressAndEgress, AVPs can be removed from both ingress and egress messages.",
"enum": [
"Egress",
"Ingress",
"IngressAndEgress"
],
"type": "string"
},
"messageType": {
"description": "When set to RequestOnly, AVPs can be removed only from request messages. When set to AnswerOnly, AVPs can be removed only from answer messages. When set to RequestAndAnswer, AVPs can be removed from both request and answer messages.",
"enum": [
"AnswerOnly",
"RequestAndAnswer",
"RequestOnly"
],
"type": "string"
},
"name": {
"description": "Name for this AVP Removal List, which must be unique within the DSR site. A name is required, and cannot be changed after the AVP Removal List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"avp",
"direction",
"messageType",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"avp": [
{
"avpCode": 1000,
"avpName": "testAVP",
"vendorId": 4242,
"vendorName": "testVendor"
},
{
"avpCode": 2000,
"avpName": "testAVP2",
"vendorId": 908,
"vendorName": "testVendor2"
}
],
"configurationLevel": "8675309",
"direction": "Ingress",
"messageType": "RequestAndAnswer",
"name": "AvpRemovalList1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/avpremovallists/{name}
Updates the configuration for the specified AVP Removal List. If the provided AVP Removal List data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/avpremovallist/avpremovallist.json",
"properties": {
"avp": {
"description": "The AVPs associated with this AVP Removal List. An AVP Removal List must have between one and ten AVPs in the list.",
"items": {
"properties": {
"avpCode": {
"description": "The 32-bit number that, when combined with the vendorId value, uniquely identifies the Diameter attribute.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"avpName": {
"description": "User-defined name associated with this avpCode. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
},
"vendorId": {
"description": "The 32-bit number that identifies the vendor for vendor-specific AVPs. If the avpCode is not vendor-specific, the vendorId field should be zero.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"vendorName": {
"description": "User-defined name associated with the vendorId value. Informational only - it is not used by the DSR when executing AVP Removal Lists.",
"maxLength": 32,
"type": "string"
}
},
"required": [
"avpCode",
"vendorId"
],
"type": "object"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"direction": {
"description": "When set to Ingress, only messages (request or answer) entering the DSR can be stripped of the AVPs in the list. When set to Egress, AVPs can only be removed from messages exiting the DSR. When set to IngressAndEgress, AVPs can be removed from both ingress and egress messages.",
"enum": [
"Egress",
"Ingress",
"IngressAndEgress"
],
"type": "string"
},
"messageType": {
"description": "When set to RequestOnly, AVPs can be removed only from request messages. When set to AnswerOnly, AVPs can be removed only from answer messages. When set to RequestAndAnswer, AVPs can be removed from both request and answer messages.",
"enum": [
"AnswerOnly",
"RequestAndAnswer",
"RequestOnly"
],
"type": "string"
},
"name": {
"description": "Name for this AVP Removal List, which must be unique within the DSR site. A name is required, and cannot be changed after the AVP Removal List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"avp",
"direction",
"messageType",
"name"
],
"type": "object"
}
Example
{
"avp": [
{
"avpCode": 1000,
"avpName": "testAVP",
"vendorId": 4242,
"vendorName": "testVendor"
},
{
"avpCode": 2000,
"avpName": "testAVP2",
"vendorId": 908,
"vendorName": "testVendor2"
}
],
"configurationLevel": "8675309",
"direction": "Ingress",
"messageType": "RequestAndAnswer",
"name": "AvpRemovalList1"
}
delete /diameter/avpremovallists/{name}
Deletes the specified AVP Removal List from the SOAM configuration. An AVP Removal List can only be deleted if all delete validation checks pass. In general, if the AVP Removal List is part of the configuration of some other Managed Object, the AVP Removal List cannot be deleted. For example, if the AVP Removal List is named by a Peer Node (/diameter/peernodes), the AVP Removal List must first be removed from the Peer Node. Then the AVP Removal List can be deleted from the configuration. An attempt to delete an AVP Removal List that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: AF/pCSCF Topology Hiding Configuration Sets
S9 AF/pCSCF Topology Hiding Configuration Sets provide information that is used to perform S9 AF/pCSCF Topology Hiding for a Protected Network PCRFs, as well as the number of PCRFs in the network, when it exchanges messages with Untrusted Networks. A PCRF's identity is embedded in the Origin-Host and Session-ID AVPs sent in Request messages and the Origin-Host AVP sent in Answer messages.
All S9 AF/pCSCF Topology Hiding Configuration Set configuration is done at the NOAM.
/diameter/aftopologyhidingcfgsets
get /diameter/aftopologyhidingcfgsets
Returns all S9 AF/pCSCF Topology Hiding Configuration Sets configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those S9 AF/pCSCF Topology Hiding Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/aftopologyhidingcfgsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/aftopologyhidingcfgset/aftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 AF/pCSCF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 AF/pCSCF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 1200,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 AF/pCSCF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 AF/pCSCF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestAfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/aftopologyhidingcfgsets
Adds a new S9 AF/pCSCF Topology Hiding Configuration Set to the DSR configuration. The new S9 AF/pCSCF Topology Hiding Configuration Set must have a name that is unique to the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/aftopologyhidingcfgset/aftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 AF/pCSCF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 AF/pCSCF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 1200,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 AF/pCSCF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 AF/pCSCF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestAfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/aftopologyhidingcfgsets/{name}
get /diameter/aftopologyhidingcfgsets/{name}
Returns the configuration details for the specified S9 AF/pCSCF Topology Hiding Configuration Set. If the specified S9 AF/pCSCF Topology Hiding Configuration Set does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/aftopologyhidingcfgsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/aftopologyhidingcfgset/aftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 AF/pCSCF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 AF/pCSCF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 1200,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 AF/pCSCF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 AF/pCSCF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestAfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/aftopologyhidingcfgsets/{name}
Updates the configuration for the specified S9 AF/pCSCF Topology Hiding Configuration Set. If the provided S9 AF/pCSCF Topology Hiding Configuration Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/aftopologyhidingcfgset/aftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 AF/pCSCF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 AF/pCSCF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 1200,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 AF/pCSCF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 AF/pCSCF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestAfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
delete /diameter/aftopologyhidingcfgsets/{name}
Deletes the specified S9 AF/pCSCF Topology Hiding Configuration Set from the NOAM configuration. An S9 AF/pCSCF Topology Hiding Configuration Set can only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Capacity Configuration Sets
Capacity Configuration Sets provide a mechanism for adjusting a Connection (/diameter/connections) to account for the network quality of service and Peer Node (/diameter/peernodes) requirements, and allow management of capacity data for Diameter Connections. Each Connection has a Capacity Configuration Set assigned to it so the attributes of Capacity Configuration Set essentially become attributes of the Connection(s) to which it is assigned.
The Capacity Configuration Set named Default is always available. The Default Capacity Configuration Set can be modified, but it cannot be deleted.
All Capacity Configuration Set configuration is done at the SOAM.
/diameter/capacityconfigurationsets
get /diameter/capacityconfigurationsets
Returns all Capacity Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Capacity Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/capacityconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/capacityconfigurationset/capacityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"ingressMpsMajorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a major alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Major Alarm Threshold. The Major Alarm Threshold must be greater than the Minor Alarm Threshold. Typical value is 80.",
"maximum": 100,
"minimum": 11,
"type": "integer"
},
"ingressMpsMinorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a minor alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Minor Alarm Threshold. The Minor Alarm Threshold must be less than the Major Alarm Threshold. Typical value is 50.",
"maximum": 99,
"minimum": 10,
"type": "integer"
},
"maxIngressMps": {
"description": "The maximum rate ingress messages per second that a Diameter Connection using this Capacity Configuration Set is allowed to process. The maximum ingress MPS must be greater than or equal to the reserved ingress MPS. Any difference between the maximum ingress MPS and the reserved ingress MPS represents MP server resources that are shared among Connections using this Capacity Configuration Set. Typical value is 10000.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for the Capacity Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Capacity Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"reservedIngressMpsAbatementTime": {
"description": "The time, in milliseconds, a Connection's ingress message rate must remain 5% below an alarm onset threshold before clearing. Typical value is 2000.",
"maximum": 5000,
"minimum": 1000,
"type": "integer"
},
"reservedIngressMps": {
"description": "The capacity, in messages per second, explicitly reserved for a Connection (/diameter/connections) that is assigned this Capacity Configuration Set. Typical value is 0.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"convergenceTime",
"ingressMpsMajorAlarmThreshold",
"ingressMpsMinorAlarmThreshold",
"maxIngressMps",
"name",
"reservedIngressMpsAbatementTime",
"reservedIngressMps"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "47",
"convergenceTime": 1000,
"ingressMpsMajorAlarmThreshold": 80,
"ingressMpsMinorAlarmThreshold": 50,
"maxIngressMps": 10000,
"name": "CapacityConfigurationSet1",
"reservedIngressMpsAbatementTime": 2000,
"reservedIngressMps": 0
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/capacityconfigurationsets
Adds a new Capacity Configuration Set to the DSR configuration. The new Capacity Configuration Set must have a name that is unique across all Capacity Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/capacityconfigurationset/capacityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"ingressMpsMajorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a major alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Major Alarm Threshold. The Major Alarm Threshold must be greater than the Minor Alarm Threshold. Typical value is 80.",
"maximum": 100,
"minimum": 11,
"type": "integer"
},
"ingressMpsMinorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a minor alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Minor Alarm Threshold. The Minor Alarm Threshold must be less than the Major Alarm Threshold. Typical value is 50.",
"maximum": 99,
"minimum": 10,
"type": "integer"
},
"maxIngressMps": {
"description": "The maximum rate ingress messages per second that a Diameter Connection using this Capacity Configuration Set is allowed to process. The maximum ingress MPS must be greater than or equal to the reserved ingress MPS. Any difference between the maximum ingress MPS and the reserved ingress MPS represents MP server resources that are shared among Connections using this Capacity Configuration Set. Typical value is 10000.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for the Capacity Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Capacity Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"reservedIngressMpsAbatementTime": {
"description": "The time, in milliseconds, a Connection's ingress message rate must remain 5% below an alarm onset threshold before clearing. Typical value is 2000.",
"maximum": 5000,
"minimum": 1000,
"type": "integer"
},
"reservedIngressMps": {
"description": "The capacity, in messages per second, explicitly reserved for a Connection (/diameter/connections) that is assigned this Capacity Configuration Set. Typical value is 0.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"convergenceTime",
"ingressMpsMajorAlarmThreshold",
"ingressMpsMinorAlarmThreshold",
"maxIngressMps",
"name",
"reservedIngressMpsAbatementTime",
"reservedIngressMps"
],
"type": "object"
}
Example
{
"configurationLevel": "47",
"convergenceTime": 1000,
"ingressMpsMajorAlarmThreshold": 80,
"ingressMpsMinorAlarmThreshold": 50,
"maxIngressMps": 10000,
"name": "CapacityConfigurationSet1",
"reservedIngressMpsAbatementTime": 2000,
"reservedIngressMps": 0
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/capacityconfigurationsets/{name}
get /diameter/capacityconfigurationsets/{name}
Returns the configuration details for the specified Capacity Configuration Set. If the Capacity Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/capacityconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/capacityconfigurationset/capacityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"ingressMpsMajorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a major alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Major Alarm Threshold. The Major Alarm Threshold must be greater than the Minor Alarm Threshold. Typical value is 80.",
"maximum": 100,
"minimum": 11,
"type": "integer"
},
"ingressMpsMinorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a minor alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Minor Alarm Threshold. The Minor Alarm Threshold must be less than the Major Alarm Threshold. Typical value is 50.",
"maximum": 99,
"minimum": 10,
"type": "integer"
},
"maxIngressMps": {
"description": "The maximum rate ingress messages per second that a Diameter Connection using this Capacity Configuration Set is allowed to process. The maximum ingress MPS must be greater than or equal to the reserved ingress MPS. Any difference between the maximum ingress MPS and the reserved ingress MPS represents MP server resources that are shared among Connections using this Capacity Configuration Set. Typical value is 10000.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for the Capacity Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Capacity Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"reservedIngressMpsAbatementTime": {
"description": "The time, in milliseconds, a Connection's ingress message rate must remain 5% below an alarm onset threshold before clearing. Typical value is 2000.",
"maximum": 5000,
"minimum": 1000,
"type": "integer"
},
"reservedIngressMps": {
"description": "The capacity, in messages per second, explicitly reserved for a Connection (/diameter/connections) that is assigned this Capacity Configuration Set. Typical value is 0.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"convergenceTime",
"ingressMpsMajorAlarmThreshold",
"ingressMpsMinorAlarmThreshold",
"maxIngressMps",
"name",
"reservedIngressMpsAbatementTime",
"reservedIngressMps"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "47",
"convergenceTime": 1000,
"ingressMpsMajorAlarmThreshold": 80,
"ingressMpsMinorAlarmThreshold": 50,
"maxIngressMps": 10000,
"name": "CapacityConfigurationSet1",
"reservedIngressMpsAbatementTime": 2000,
"reservedIngressMps": 0
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/capacityconfigurationsets/{name}
Updates the configuration of the specified Capacity Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/capacityconfigurationset/capacityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"ingressMpsMajorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a major alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Major Alarm Threshold. The Major Alarm Threshold must be greater than the Minor Alarm Threshold. Typical value is 80.",
"maximum": 100,
"minimum": 11,
"type": "integer"
},
"ingressMpsMinorAlarmThreshold": {
"description": "The percentage of the Maximum Ingress MPS at which a minor alarm is raised for connections using the Capacity Configuration Set. Once an alarm is raised, it is not cleared until the ingress MPS falls 5% or more below the ingress Capacity Minor Alarm Threshold. The Minor Alarm Threshold must be less than the Major Alarm Threshold. Typical value is 50.",
"maximum": 99,
"minimum": 10,
"type": "integer"
},
"maxIngressMps": {
"description": "The maximum rate ingress messages per second that a Diameter Connection using this Capacity Configuration Set is allowed to process. The maximum ingress MPS must be greater than or equal to the reserved ingress MPS. Any difference between the maximum ingress MPS and the reserved ingress MPS represents MP server resources that are shared among Connections using this Capacity Configuration Set. Typical value is 10000.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for the Capacity Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Capacity Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"reservedIngressMpsAbatementTime": {
"description": "The time, in milliseconds, a Connection's ingress message rate must remain 5% below an alarm onset threshold before clearing. Typical value is 2000.",
"maximum": 5000,
"minimum": 1000,
"type": "integer"
},
"reservedIngressMps": {
"description": "The capacity, in messages per second, explicitly reserved for a Connection (/diameter/connections) that is assigned this Capacity Configuration Set. Typical value is 0.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
}
},
"required": [
"convergenceTime",
"ingressMpsMajorAlarmThreshold",
"ingressMpsMinorAlarmThreshold",
"maxIngressMps",
"name",
"reservedIngressMpsAbatementTime",
"reservedIngressMps"
],
"type": "object"
}
Example
{
"configurationLevel": "47",
"convergenceTime": 1000,
"ingressMpsMajorAlarmThreshold": 80,
"ingressMpsMinorAlarmThreshold": 50,
"maxIngressMps": 10000,
"name": "CapacityConfigurationSet1",
"reservedIngressMpsAbatementTime": 2000,
"reservedIngressMps": 0
}
delete /diameter/capacityconfigurationsets/{name}
Deletes the specified Capacity Configuration Set from the SOAM configuration. The Default Capacity Configuration Set cannot be deleted. A Capacity Configuration Set can only be deleted if all delete validation checks pass. In general, if the Capacity Configuration Set is part of the configuration of one or more Connections (/diameter/connections), the Capacity Configuration Set cannot be deleted. If the Capacity Configuration Set is named in Connections, the Capacity Configuration Set must first be removed from the Connection. Then the Capacity Configuration Set can be deleted from the configuration. An attempt to delete a Capacity Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Capacity Summary
Capacity summary provides information about maximum allowed, currently configured, and utilisation percentage of Diameter resources. This information is available system-wide.
/diameter/capacitysummary
get /diameter/capacitysummary
Returns the capacity summary of Diameter resources in a valid GET request.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/capacitysummaryCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/capacitysummary/capacitysummary.json",
"properties": {
"maximumCapacity":{
"description": "Maximum number of entries for the resourceName that can be configured in Diameter.",
"maximum": 2147483647,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"resourceName":{
"description": "Resource Name",
"maxLength": 255,
"pattern": "^[a-zA-Z][a-zA-Z]*$",
"readOnly": true,
"type": "string"
},
"usedCapacity":{
"description": "Number of entries that are already configured for the resourceName.",
"maximum": 2147483647,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"utilizationPercent":{
"description": "Utilization percentage of entries that are already configured for the resourceName.",
"maximum": 100,
"minimum": 0,
"readOnly": true,
"type": "float"
},
"type": "object"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
[
{
"maximumCapacity": "1000",
"resourceName": "Application Id",
"usedCapacity": "8",
"utilizationpercent": 0.8
},
{
"maximumCapacity": "128",
"resourceName": "Egress Throttle Group",
"usedCapacity": "2",
"utilizationpercent": 1.6
}
]
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: CEX Configuration Sets
A Capabilities Exchange (CEX) Configuration Set encapsulates a number of parameters that are used in the first interaction between Diameter nodes, called the capabilities exchange. By collecting these parameters into a configuration set, the set of parameters can be easily assigned to multiple Connections (/diameter/connections). The DSR and a Peer Node (/diameter/peernodes) negotiating to connect use the Diameter Application Ids (/diameter/applicationids) in the CEX Configuration Set to determine if they have enough Diameter functionality in common to establish the Connection and thus begin to transact Diameter messages.
All CEX Configuration Set configuration is done at the SOAM.
/diameter/cexconfigurationsets
get /diameter/cexconfigurationsets
Returns all CEX Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those CEX Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/cexconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/cexconfigurationset/cexconfigurationset.json",
"properties": {
"clientMustIncludeAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) which a Peer Node (/diameter/peernodes) must support in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If the Peer Node does not support all of the Diameter Application Ids (/diameter/applicationids) contained in this list of CEX Parameters (a CEX Parameter is defined in large part by its Diameter Application Id), the Connection would not be established. The Application Ids in clientMustIncludeAppIds are always considered a subset of the DSR-supported Application Ids. So clientMustIncludeAppIds and dsrSupportedAppIds together form the complete set of Application Ids (via CEX Parameters) that the DSR supports on a Connection assigned this CEX Configuration Set. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dsrSupportedAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) that the DSR supports, but which a Peer Node (/diameter/peernodes) is not required to support, in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If clientMustIncludeAppIds is empty (meaning the DSR is not requiring a Peer Node to support a particular Application Id (/diameter/applicationids) in order for the Connection to be established), then there must be at least one Application Id in dsrSupportedAppIds that the Peer Node also supports (unless the Relay Application Id, 424967295, is specified). Otherwise the Connection would not be established. If clientMustIncludeAppIds is not empty, then the Peer Node must support all Application Ids in that list. In that case, the Connection can be established, and any overlap between dsrSupportedAppIds and additional Application Ids the Peer Node supports simply represents additional Diameter functionality the two nodes have in common. Note: any time dsrSupportedAppIds includes the Relay Application Id, 424967295, and clientMustIncludeAppIds is empty, the DSR allows the Connection to come up. In this case the DSR is advertising its relay capability, which is not limited to any particular Application Id. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"dsrSupportedVendorIds": {
"description": "List of vendor IDs the DSR supports. Each vendor ID in this list must be one of the vendor IDs configured for vendor-specific Application IDs (/diameter/applicationids) within the CEX Parameters (/diameter/cexparameters) configuration.",
"items": {
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"includeDsrFeatureStatusAvp": {
"description": "If true, the Oracle-specific DSR Feature Status AVP is included in CER/CEA messages sent by the DSR as part of the capabilities exchange process. Typically, this value is only set to true for Connections (/diameter/connections) between two DSRs.",
"type": "boolean"
},
"isDynamic": {
"description": "If true, means the CEX Configuration Set was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"name": {
"description": "Name for the CEX Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all CEX Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"includeDsrFeatureStatusAvp",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"clientMustIncludeAppIds": [
{
"appId": 4294967295,
"appIdType": "Authentication"
},
{
"appId": 16777224,
"appIdType": "Authentication",
"vendorId": 323
}
],
"configurationLevel": "888",
"dsrSupportedAppIds": [
{
"appId": 16777217,
"appIdType": "Authentication",
"vendorId": 323
}
],
"dsrSupportedVendorIds": [
323
],
"includeDsrFeatureStatusAvp": false,
"isDynamic": false,
"name": "cexCfgSet111"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/cexconfigurationsets
Adds a new CEX Configuration Set to the DSR configuration. The new CEX Configuration Set must have a name that is unique across all CEX Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/cexconfigurationset/cexconfigurationset.json",
"properties": {
"clientMustIncludeAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) which a Peer Node (/diameter/peernodes) must support in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If the Peer Node does not support all of the Diameter Application Ids (/diameter/applicationids) contained in this list of CEX Parameters (a CEX Parameter is defined in large part by its Diameter Application Id), the Connection would not be established. The Application Ids in clientMustIncludeAppIds are always considered a subset of the DSR-supported Application Ids. So clientMustIncludeAppIds and dsrSupportedAppIds together form the complete set of Application Ids (via CEX Parameters) that the DSR supports on a Connection assigned this CEX Configuration Set. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dsrSupportedAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) that the DSR supports, but which a Peer Node (/diameter/peernodes) is not required to support, in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If clientMustIncludeAppIds is empty (meaning the DSR is not requiring a Peer Node to support a particular Application Id (/diameter/applicationids) in order for the Connection to be established), then there must be at least one Application Id in dsrSupportedAppIds that the Peer Node also supports (unless the Relay Application Id, 424967295, is specified). Otherwise the Connection would not be established. If clientMustIncludeAppIds is not empty, then the Peer Node must support all Application Ids in that list. In that case, the Connection can be established, and any overlap between dsrSupportedAppIds and additional Application Ids the Peer Node supports simply represents additional Diameter functionality the two nodes have in common. Note: any time dsrSupportedAppIds includes the Relay Application Id, 424967295, and clientMustIncludeAppIds is empty, the DSR allows the Connection to come up. In this case the DSR is advertising its relay capability, which is not limited to any particular Application Id. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"dsrSupportedVendorIds": {
"description": "List of vendor IDs the DSR supports. Each vendor ID in this list must be one of the vendor IDs configured for vendor-specific Application IDs (/diameter/applicationids) within the CEX Parameters (/diameter/cexparameters) configuration.",
"items": {
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"includeDsrFeatureStatusAvp": {
"description": "If true, the Oracle-specific DSR Feature Status AVP is included in CER/CEA messages sent by the DSR as part of the capabilities exchange process. Typically, this value is only set to true for Connections (/diameter/connections) between two DSRs.",
"type": "boolean"
},
"isDynamic": {
"description": "If true, means the CEX Configuration Set was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"name": {
"description": "Name for the CEX Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all CEX Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"includeDsrFeatureStatusAvp",
"name"
],
"type": "object"
}
Example
{
"clientMustIncludeAppIds": [
{
"appId": 4294967295,
"appIdType": "Authentication"
},
{
"appId": 16777224,
"appIdType": "Authentication",
"vendorId": 323
}
],
"configurationLevel": "888",
"dsrSupportedAppIds": [
{
"appId": 16777217,
"appIdType": "Authentication",
"vendorId": 323
}
],
"dsrSupportedVendorIds": [
323
],
"includeDsrFeatureStatusAvp": false,
"isDynamic": false,
"name": "cexCfgSet111"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/cexconfigurationsets/{name}
get /diameter/cexconfigurationsets/{name}
Returns the configuration details for the specified CEX Configuration Set. If the CEX Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/cexconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/cexconfigurationset/cexconfigurationset.json",
"properties": {
"clientMustIncludeAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) which a Peer Node (/diameter/peernodes) must support in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If the Peer Node does not support all of the Diameter Application Ids (/diameter/applicationids) contained in this list of CEX Parameters (a CEX Parameter is defined in large part by its Diameter Application Id), the Connection would not be established. The Application Ids in clientMustIncludeAppIds are always considered a subset of the DSR-supported Application Ids. So clientMustIncludeAppIds and dsrSupportedAppIds together form the complete set of Application Ids (via CEX Parameters) that the DSR supports on a Connection assigned this CEX Configuration Set. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dsrSupportedAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) that the DSR supports, but which a Peer Node (/diameter/peernodes) is not required to support, in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If clientMustIncludeAppIds is empty (meaning the DSR is not requiring a Peer Node to support a particular Application Id (/diameter/applicationids) in order for the Connection to be established), then there must be at least one Application Id in dsrSupportedAppIds that the Peer Node also supports (unless the Relay Application Id, 424967295, is specified). Otherwise the Connection would not be established. If clientMustIncludeAppIds is not empty, then the Peer Node must support all Application Ids in that list. In that case, the Connection can be established, and any overlap between dsrSupportedAppIds and additional Application Ids the Peer Node supports simply represents additional Diameter functionality the two nodes have in common. Note: any time dsrSupportedAppIds includes the Relay Application Id, 424967295, and clientMustIncludeAppIds is empty, the DSR allows the Connection to come up. In this case the DSR is advertising its relay capability, which is not limited to any particular Application Id. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"dsrSupportedVendorIds": {
"description": "List of vendor IDs the DSR supports. Each vendor ID in this list must be one of the vendor IDs configured for vendor-specific Application IDs (/diameter/applicationids) within the CEX Parameters (/diameter/cexparameters) configuration.",
"items": {
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"includeDsrFeatureStatusAvp": {
"description": "If true, the Oracle-specific DSR Feature Status AVP is included in CER/CEA messages sent by the DSR as part of the capabilities exchange process. Typically, this value is only set to true for Connections (/diameter/connections) between two DSRs.",
"type": "boolean"
},
"isDynamic": {
"description": "If true, means the CEX Configuration Set was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"name": {
"description": "Name for the CEX Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all CEX Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"includeDsrFeatureStatusAvp",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"clientMustIncludeAppIds": [
{
"appId": 4294967295,
"appIdType": "Authentication"
},
{
"appId": 16777224,
"appIdType": "Authentication",
"vendorId": 323
}
],
"configurationLevel": "888",
"dsrSupportedAppIds": [
{
"appId": 16777217,
"appIdType": "Authentication",
"vendorId": 323
}
],
"dsrSupportedVendorIds": [
323
],
"includeDsrFeatureStatusAvp": false,
"isDynamic": false,
"name": "cexCfgSet111"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/cexconfigurationsets/{name}
Updates the configuration of the specified CEX Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/cexconfigurationset/cexconfigurationset.json",
"properties": {
"clientMustIncludeAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) which a Peer Node (/diameter/peernodes) must support in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If the Peer Node does not support all of the Diameter Application Ids (/diameter/applicationids) contained in this list of CEX Parameters (a CEX Parameter is defined in large part by its Diameter Application Id), the Connection would not be established. The Application Ids in clientMustIncludeAppIds are always considered a subset of the DSR-supported Application Ids. So clientMustIncludeAppIds and dsrSupportedAppIds together form the complete set of Application Ids (via CEX Parameters) that the DSR supports on a Connection assigned this CEX Configuration Set. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dsrSupportedAppIds": {
"description": "List of CEX Parameters (/diameter/cexparameters) that the DSR supports, but which a Peer Node (/diameter/peernodes) is not required to support, in order for a Connection (/diameter/connections) to be established between the DSR and the Peer Node. If clientMustIncludeAppIds is empty (meaning the DSR is not requiring a Peer Node to support a particular Application Id (/diameter/applicationids) in order for the Connection to be established), then there must be at least one Application Id in dsrSupportedAppIds that the Peer Node also supports (unless the Relay Application Id, 424967295, is specified). Otherwise the Connection would not be established. If clientMustIncludeAppIds is not empty, then the Peer Node must support all Application Ids in that list. In that case, the Connection can be established, and any overlap between dsrSupportedAppIds and additional Application Ids the Peer Node supports simply represents additional Diameter functionality the two nodes have in common. Note: any time dsrSupportedAppIds includes the Relay Application Id, 424967295, and clientMustIncludeAppIds is empty, the DSR allows the Connection to come up. In this case the DSR is advertising its relay capability, which is not limited to any particular Application Id. Both clientMustIncludeAppIds and dsrSupportedAppIds cannot simultaneously be empty lists.",
"items": {
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"dsrSupportedVendorIds": {
"description": "List of vendor IDs the DSR supports. Each vendor ID in this list must be one of the vendor IDs configured for vendor-specific Application IDs (/diameter/applicationids) within the CEX Parameters (/diameter/cexparameters) configuration.",
"items": {
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"includeDsrFeatureStatusAvp": {
"description": "If true, the Oracle-specific DSR Feature Status AVP is included in CER/CEA messages sent by the DSR as part of the capabilities exchange process. Typically, this value is only set to true for Connections (/diameter/connections) between two DSRs.",
"type": "boolean"
},
"isDynamic": {
"description": "If true, means the CEX Configuration Set was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"name": {
"description": "Name for the CEX Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all CEX Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"includeDsrFeatureStatusAvp",
"name"
],
"type": "object"
}
Example
{
"clientMustIncludeAppIds": [
{
"appId": 4294967295,
"appIdType": "Authentication"
},
{
"appId": 16777224,
"appIdType": "Authentication",
"vendorId": 323
}
],
"configurationLevel": "888",
"dsrSupportedAppIds": [
{
"appId": 16777217,
"appIdType": "Authentication",
"vendorId": 323
}
],
"dsrSupportedVendorIds": [
323
],
"includeDsrFeatureStatusAvp": false,
"isDynamic": false,
"name": "cexCfgSet111"
}
delete /diameter/cexconfigurationsets/{name}
Deletes the specified CEX Configuration Set from the SOAM configuration. The Default CEX Configuration Set cannot be deleted. A CEX Configuration Set can only be deleted if all delete validation checks pass. In general, if the CEX Configuration Set is part of the configuration of some other Managed Object, the CEX Configuration Set cannot be deleted. For example, if the CEX Configuration Set is named by a Connection (/diameter/connections), the CEX Configuration Set must be removed from the Connection. Then the CEX Configuration Set can be deleted from the configuration. An attempt to delete a CEX Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: CEX Parameters
A Capabilities Exchange (CEX) Parameter is an association between a Diameter Application and an application type and vendor Id. CEX Parameters are selected in the Capabilities Exchange Configuration Sets (/diameter/cexconfigurationsets), which are used by Diameter Connections (/diameter/connections) for performing Capabilities Exchange with a Diameter Peer Node (/diameter/peernodes).
When a Vendor-specific Application Id ranging from 16777216 to 4194967294 is selected, a valid Vendor Id must also be provided.
The CEX Parameter resource has no natural identifier within the DSR - each instance is not explicitly named. But to support the DELETE operation, DSR must provide an identifier to be used in the URI. The id field in the JSON schemas serves this purpose. Clients do not need to provide a value for id in the JSON data when submitting POST requests. The id value DSR supplies in a GET response only needs to be used in the URI for any subsequent DELETE.
All Capabilities Exchange Parameter configuration is done at the SOAM.
/diameter/cexparameters
get /diameter/cexparameters
Returns all CEX Parameters configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those CEX Parameters meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/cexparameterCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/cexparameter/cexparameter.json",
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the CEX Parameter instance (which has no name).",
"maxLength": 36,
"readOnly": true,
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"appId",
"appIdType"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"appId": 4294967295,
"appIdType": "Authentication",
"configurationLevel": "123",
"id": "4294967295-Authentication-1",
"vendorId": 1
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/cexparameters
Adds a new Capabilities Exchange Parameter to the DSR configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/cexparameter/cexparameter.json",
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the CEX Parameter instance (which has no name).",
"maxLength": 36,
"readOnly": true,
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"appId",
"appIdType"
],
"type": "object"
}
Example
{
"appId": 4294967295,
"appIdType": "Authentication",
"configurationLevel": "123",
"id": "4294967295-Authentication-1",
"vendorId": 1
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/cexparameters/{id}
get /diameter/cexparameters/{id}
Returns the configuration details for the specified Capabilities Exchange Parameter. If the specified CEX Parameter does not exist in the SOAM's configuration, an error message is returned within the HTTP response. A CEX Parameter instance is uniquely identified by the id attribute returned in the JSON data accompanying a GET response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/cexparameterItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/cexparameter/cexparameter.json",
"properties": {
"appId": {
"description": "The Application Id is the numeric value that identifies a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appIdType": {
"description": "Indicates the type of the appId present in a Capabilities Exchange message. Valid values are Authentication and Accounting.",
"enum": [
"Authentication",
"Accounting"
],
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the CEX Parameter instance (which has no name).",
"maxLength": 36,
"readOnly": true,
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Capabilities Exchange message sent when a vendor-specific appId is selected. When a Vendor-specific appId ranging from 16777216 to 4194967294 is selected, a valid vendorId must also be provided.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"appId",
"appIdType"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"appId": 4294967295,
"appIdType": "Authentication",
"configurationLevel": "123",
"id": "4294967295-Authentication-1",
"vendorId": 1
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /diameter/cexparameters/{id}
Deletes the specified Capabilities Exchange Parameter from the SOAM configuration. A CEX Parameter can only be deleted if all delete validation checks pass. In general, if the CEX Parameter is part of the configuration of some other Managed Object, the CEX Parameter cannot be deleted. For example, if the CEX Parameter is named in a Capabilities Exchange Configuration Set (/diameter/cexconfigurationsets), the CEX Parameter must first be removed from the Capabilities Exchange Configuration Set. Then the CEX Parameter can be deleted from the configuration. An attempt to delete a CEX Parameter that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Diameter: Command Codes
Application Routing Rules (/diameter/applicationrouterules), Peer Routing Rules (/diameter/peerrouterules), and other configuration resources use the Command Code parameter to further define the action that is to be taken for a particular Diameter message. A Command Code is an integer value in the range 0-16777215, and DSR clients can insert, edit, and delete Command Codes as needed.
DSR also has the concept of an Extended Command Code (ECC), which is a command code extension that includes a Command Code, an AVP code, and an AVP data value. ECCs have the format X.Y.Z, where: X is an integer in the range 0-167777215; Y and Z are unsigned 32-bit integers (range 0-4294967295); and the dots are literal. The Extended Command Code allows additional application-specific Diameter or 3GPP AVP content per Command Code. DSR clients cannot insert, edit, or delete ECCs; the DSR has a set of pre-configured ECCs that are returned in the GET response and are thus read-only to clients.
All Command Code configuration is done at the SOAM.
/diameter/commandcodes
get /diameter/commandcodes
Returns all Command Codes configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Command Codes meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/commandcodeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/commandcode/commandcode.json",
"properties": {
"cmdCode": {
"description": "Identifies the Command Code or Extended Command Code associated with a message. The Command Code is an integer (represented as a string) in the range 0-16777215, while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. Extended Command Codes are read-only to DSR clients, while Command Codes can be inserted, edited, and deleted by clients.",
"maxLength": 30,
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Client-assigned name associated with cmdCode.",
"maxLength": 64,
"type": "string"
}
},
"required": [
"cmdCode",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"cmdCode": "16777211",
"configurationLevel": "123",
"name": "Default"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/commandcodes
Adds a new Command Code to the DSR configuration. The Command Code must be unique and have an associated Command Code Name. Only Command Codes can be added; Extended Command Codes are effectely read-only to DSR clients.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/commandcode/commandcode.json",
"properties": {
"cmdCode": {
"description": "Identifies the Command Code or Extended Command Code associated with a message. The Command Code is an integer (represented as a string) in the range 0-16777215, while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. Extended Command Codes are read-only to DSR clients, while Command Codes can be inserted, edited, and deleted by clients.",
"maxLength": 30,
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Client-assigned name associated with cmdCode.",
"maxLength": 64,
"type": "string"
}
},
"required": [
"cmdCode",
"name"
],
"type": "object"
}
Example
{
"cmdCode": "16777211",
"configurationLevel": "123",
"name": "Default"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/commandcodes/{cmdCode}
get /diameter/commandcodes/{cmdCode}
Returns the Command Code or Extended Command Code identified in the GET request. If the specified Command Code/ECC does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- cmdCode: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/commandcodeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/commandcode/commandcode.json",
"properties": {
"cmdCode": {
"description": "Identifies the Command Code or Extended Command Code associated with a message. The Command Code is an integer (represented as a string) in the range 0-16777215, while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. Extended Command Codes are read-only to DSR clients, while Command Codes can be inserted, edited, and deleted by clients.",
"maxLength": 30,
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Client-assigned name associated with cmdCode.",
"maxLength": 64,
"type": "string"
}
},
"required": [
"cmdCode",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"cmdCode": "16777211",
"configurationLevel": "123",
"name": "Default"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/commandcodes/{cmdCode}
Updates the associated Command Code name for the provided Command Code.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- cmdCode: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/commandcode/commandcode.json",
"properties": {
"cmdCode": {
"description": "Identifies the Command Code or Extended Command Code associated with a message. The Command Code is an integer (represented as a string) in the range 0-16777215, while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. Extended Command Codes are read-only to DSR clients, while Command Codes can be inserted, edited, and deleted by clients.",
"maxLength": 30,
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Client-assigned name associated with cmdCode.",
"maxLength": 64,
"type": "string"
}
},
"required": [
"cmdCode",
"name"
],
"type": "object"
}
Example
{
"cmdCode": "16777211",
"configurationLevel": "123",
"name": "Default"
}
delete /diameter/commandcodes/{cmdCode}
Deletes the specified Command Code from the SOAM configuration. A Command Code can only be deleted if all delete validation checks pass. In general, if the Command Code is part of the configuration of some other Managed Object, the Command Code cannot be deleted. For example, if the Command Code is named by a Peer Route Rule (/diameter/peerouterules), the Command Code must first be removed from the Peer Route Rule. Then the Command Code can be deleted from the configuration. An attempt to delete a Command Code that cannot be deleted results in an error message within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- cmdCode: required (string)
Diameter: Common Application Options
The Common Application Options are those configuration values that govern the overall application functionality and are not directly related to any particular Target Set. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new IPFE Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All Common Application Options configuration is done at the NOAM.
/diameter/commonapplicationoptions
get /diameter/commonapplicationoptions
Returns the set of current values for the Common Application Options.
Target Server: NOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/commonappoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/commonappoption/commonappoption.json",
"properties": {
"enableEnhancedOverloadControl": {
"description": "If the Enhanced Overload Control Function is disabled, the existing PCA/SBR overload control function developed prior to Release 8.1 applies to those DA-MPs and SBR MPs where the DRMP feature is disabled. If the Enhanced Overload Control Function is enabled, the enhanced overload control function developed in Release 8.1 applies to all PCA DA-MPs and SBR MPs under the same NO toploogy, and all PCA DA-MPs and SBR MPs needs to be restarted.",
"type": "boolean"
}
},
"required": [
"enableEnhancedOverloadControl"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"enhancedoverloadcontrolfunction": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
put /diameter/commonapplicationoptions
Updates the Common Application Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: NOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/commonappoption/commonappoption.json",
"properties": {
"enableEnhancedOverloadControl": {
"description": "If the Enhanced Overload Control Function is disabled, the existing PCA/SBR overload control function developed prior to Release 8.1 applies to those DA-MPs and SBR MPs where the DRMP feature is disabled. If the Enhanced Overload Control Function is enabled, the enhanced overload control function developed in Release 8.1 applies to all PCA DA-MPs and SBR MPs under the same NO toploogy, and all PCA DA-MPs and SBR MPs needs to be restarted.",
"type": "boolean"
}
},
"required": [
"enableEnhancedOverloadControl"
],
"type": "object"
}
Example
{
"enhancedoverloadcontrolfunction": true
}
Diameter: Connection Alarm Groups
Connection Alarm Group is group of connections (/diameter/connections) and each group is having throttle and abatement threshold values in % for minor, major and critical severity. Connection Alarm Group is used by alarm group feature, if alarm group feature is enabled through Options (/diameter/options).
All Connection Alarm Group configuration is done at the SOAM.
/diameter/connectionalarmgroups
get /diameter/connectionalarmgroups
Returns all Connection Alarm Groups configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Connection Alarm Groups meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/connectionalarmgroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionalarmgroup/connectionalarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Connection Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Connection Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"connectionName": {
"description": "List of Connections (/diameter/connections) that are part of this Connection Alarm Group.",
"items": {
"description": "Name of a Connection (/diameter/connections). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold",
"connectionName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"connectionName": [
"Connection1",
"Connection2",
"Connection3"
],
"name": "connectionGroup1",
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/connectionalarmgroups
Adds a new Connection Alarm Group to the DSR configuration. The new Connection Alarm Group must have a name unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionalarmgroup/connectionalarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Connection Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Connection Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"connectionName": {
"description": "List of Connections (/diameter/connections) that are part of this Connection Alarm Group.",
"items": {
"description": "Name of a Connection (/diameter/connections). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold",
"connectionName"
],
"type": "object"
}
Example
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"connectionName": [
"Connection1",
"Connection2",
"Connection3"
],
"name": "connectionGroup1",
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/connectionalarmgroups/{name}
get /diameter/connectionalarmgroups/{name}
Returns the configuration details for the specified Connection Alarm Group. If the specified Connection Alarm Group does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/connectionalarmgroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionalarmgroup/connectionalarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Connection Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Connection Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"connectionName": {
"description": "List of Connections (/diameter/connections) that are part of this Connection Alarm Group.",
"items": {
"description": "Name of a Connection (/diameter/connections). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold",
"connectionName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"connectionName": [
"Connection1",
"Connection2",
"Connection3"
],
"name": "connectionGroup1",
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/connectionalarmgroups/{name}
Updates the configuration for the specified Connection Alarm Group. If the provided Connection Alarm Group data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionalarmgroup/connectionalarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Connection Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Connection Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold. This % value indicates the number of connections failed out of total number of connections configured for that Connection Node Alarm Group. When the count of failed connections reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"connectionName": {
"description": "List of Connections (/diameter/connections) that are part of this Connection Alarm Group.",
"items": {
"description": "Name of a Connection (/diameter/connections). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold",
"connectionName"
],
"type": "object"
}
Example
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"connectionName": [
"Connection1",
"Connection2",
"Connection3"
],
"name": "connectionGroup1",
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
}
delete /diameter/connectionalarmgroups/{name}
Deletes the specified Connection Alarm Group from the SOAM configuration. A Connection Alarm Group is only deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Connection Capacity Dashboard
The Connections Table tab contains information about the currently configured Connections for each DAMP in the NE. Fixed Connections and Floating IPFE Connections displays with Floating IPFE Connections grouped by Target Set.The Connection Reserved Ingress MPS Table tab contains the currently configured Reserved Ingress MPS for each DAMP in the NE. The contribution of both Fixed Connections and Floating IPFE Connections displays with Floating IPFE Connections grouped by Target Set.
/diameter/connectioncapacitydashboard
get /diameter/connectioncapacitydashboard
Returns all Connection Capacity configured from configuration network server and server groups of NOAM and it becomes available at SOAM which meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Connection Capacities meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/connectioncapacitydashboardCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectioncapacitydashboard/connectioncapacitydashboard.json",
"properties": {
"connectionCapacity": {
"description": "The DAMP's total Connection capacity.The maximum connections value assigned to the DAMP in the MP Profile.",
"type": "integer"
},
"currentConnectionUsage": {
"description": "The percentage of the total Connection capacity currently used, which is the sum of Fixed Connections and Floating IPFE Connections allocated to the DAMP, divided by the total Connection Capacity value.It is theoretically possible for this usage value to exceed 100%; diameter does not prevent over-configuration in certain scenarios (typically involving overlapping Target Sets, or a non-overlapping Target Set whose DAMPs have significantly different numbers of Fixed Connections assigned). For a given DAMP, if the number of Connections allocated to that DAMP exceeds the DAMP's Maximum Connections count capacity (from the assigned MP Profile), the Current Connection Usage (%) value exceeds 100%.",
"minimum": 0,
"type": "integer"
},
"currentRIMPSUsage": {
"description": "The percentage of scaled Engineered Ingress MPS capacity currently used.This usage value is computed as the sum of Reserved Ingress MPS values for a DA-MP's Fixed Connections and Floating IPFE Connections, divided by the Maximum Reserved Ingress MPS value.It is theoretically possible for this usage value to exceed 100%; diameter does not prevent over-configuration in certain scenarios (typically involving overlapping Target Sets, or a non-overlapping Target Set whose DAMPs have significantly different numbers of Fixed Connections assigned).",
"minimum": 0,
"type": "integer"
},
"fixedConnections": {
"description": "The number of Fixed Connections currently configured for the DAMP.For a given DAMP, the value displayed in the # Fixed Connections field should never exceed the Connection Capacity.If a DAMP has one or more configured Fixed Connections, then the value appears as a hyperlink.",
"type": "integer"
},
"maxRIMPS": {
"description": "The DAMP's Engineered Ingress MPS value, located on the MP Profile assigned to the DAMP, scaled by the Connection Reserved Ingress MPS Scaling value located on the System Options page.",
"type": "integer"
},
"mpServerHostname": {
"description": "Hostname of the DAMP server.",
"type": "string"
},
"totalFixedConnectionRIMPS": {
"description": "The sum of the Maximum Reserved Ingress MPS values for all Fixed Connections configured to a DAMP.For a given DAMP, the value displayed in the Total Fixed Connection Reserved Ingress MPS field should not exceed the Maximum Reserved Ingress MPS value.Note:There is one exception - a system already configured with Fixed Connections having some non-zero Total Fixed Connection Reserved Ingress MPS value. If the Connection Reserved Ingress MPS Scaling is decreased, thus decreasing the scaled Engineered Ingress MPS on every DAMP in the system, it is possible the new lowered Maximum Reserved Ingress MPS is less than the already-configured Total Fixed Connection Reserved Ingress MPS. ",
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"connectionCapacity": 1000,
"currentConnectionUsage": 0,
"currentRIMPSUsage": 0,
"fixedConnections": 0,
"maxRIMPS": 40000,
"mpServerHostname": "MP1",
"totalFixedConnectionRIMPS": 0
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Connection Configuration Sets
Connection Configuration Sets provide a way to tailor a DSR connection to account for the network quality of service and Peer Node (/diameter/peernodes) requirements. A Connection Configuration Set is simply a collection of Connection (/diameter/connections) parameters that are grouped so the set can be easily assigned to multiple Connections. The parameters within a Connection Configuration Set are divided into general categories, which include TCP Options, SCTP Options, Diameter Options, and RADIUS Options. The RADIUS parameters do not apply when the Connection Configuration Set is assigned to a Diameter Connection, and the non-RADIUS parameters do not apply when the set is assigned to a RADIUS connection. The name of each parameter in the Connection Configuration Set begins with an identifier indicating which category the parameter applies to. The identifiers are diameter, radius, sctp, and tcp.
The Connection Configuration Set named Default is always available. The Default Connection Configuration Set can be modified, but it cannot be deleted.
All attributes (except for the read-only configurationLevel) for Connection Configuration Sets are marked as required in the JSON schema. A client should GET the Default instance, copy it, modify any attributes, and POST the new instance. This way, all attributes have valid values.
All configuration of the Connection Configuration Set is done at the SOAM.
/diameter/connectionconfigurationsets
get /diameter/connectionconfigurationsets
Returns all Connection Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Connection Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/connectionconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"cl1MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 4 and the range is 1-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 1 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"cl2MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL2. The typical value is 8 and the range is 2-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 2 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 2,
"type": "integer"
},
"cl3MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 16 and the range is 3-16 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 3 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 16,
"minimum": 3,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diameterCexHostIpValidationEnabled": {
"description": "If true, Host-IP-Address AVP validation is enabled during CEX message exchange. Typical value is true.",
"type": "boolean"
},
"diameterCexTimer": {
"description": "Time (in seconds) to wait on a Capabilities Exchange Request message from a Peer Node (/diameter/peernodes) after a Connection (/diameter/connections) is initiated by the Peer Node; and time to wait on a Capabilities Exchange Answer response from a Peer Node after sending the request message. For Local Nodes (/diameter/localnodes), Capabilities Exchange Answer messages are sent in response to erroneous Capabilities Exchange Request messages. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterDisconnectTimer": {
"description": "After sending a disconnect peer request message, time (in seconds) to wait for a Peer Node (/diameter/peernodes) to disconnect the Connection (/diameter/connections); and after sending a disconnect peer request message, time to wait for the Peer Node to send the answer message. If the diameterDisconnectTimer expires, the Connection is disconnected by the application. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for answer messages from the Peer Node (/diameter/peernodes) on this Connection (/diameter/connections). If the maximum is reached, this Connection is not selected for routing until the number of pending requests falls below this value. The diameterPendingTransactionsPerConnection value cannot be edited unless the Connection is disabled. Typical value is 1000.",
"maximum": 20000,
"minimum": 1,
"type": "integer"
},
"diameterProvingDeviceWatchdogRequestsToSend": {
"description": "The number of consecutive Device Watchdog Request and Answer message exchanges within a Proving Time interval during Connection (/diameter/connections) proving. Typical value is 3.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"diameterProvingMode": {
"description": "Proving mode for the Configuration Set. When set to Always, Device Watchdog Request and Answer exchanges are always done during Connection (/diameter/connections) proving. Suspect proving mode is only done when a Connection goes down due to an ungraceful disconnection (for example, no Disconnect Peer Request and Answer were exchanged when the Connection went down) and the Connection comes back up after the disconnection. When set to Never, proving is never done when a Connection goes down with the Peer Node (/diameter/peernodes) and it comes back up after a disconnection. Typical value is Suspect.",
"enum": [
"Always",
"Suspect",
"Never"
],
"type": "string"
},
"diameterProvingTimeout": {
"description": "The time (in milliseconds) to wait for a Peer Node (/diameter/peernodes) to send a Device Watchdog Answer message in response to a Device Watchdog Request message during Connection (/diameter/connections) proving. Typical value is 500.",
"maximum": 30000,
"minimum": 50,
"type": "integer"
},
"diameterTransportConnectionTimer": {
"description": "Controls the frequency (in seconds) that Connection (/diameter/connections) attempts are done to a Peer Node (/diameter/peernodes) where no active Connection exists. Applicable only for Connections configured to initiate a Connection with a Peer Node. Typical value is 30.",
"maximum": 60,
"minimum": 1,
"type": "integer"
},
"diameterWatchdogTimerInitValue": {
"description": "Initial value (in seconds) of the application watchdog timer. Typical value is 30.",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name associated with the Connection Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusCachedResponseDuration": {
"description": "Specifies the duration (in milliseconds) for which a cached response is held in the ingress transaction record. The radiusCachedResponseDuration value should cover the potential of loss of response and further retransmissions by the client. The radiusCachedResponseDuration applies only to server Connections (/diameter/connections) and only if radiusPreventDuplicateIngressRetransmission is true. Typical value is 5000.",
"maximum": 10000,
"minimum": 3000,
"type": "integer"
},
"radiusPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for a response from a Peer Node (/diameter/peernodes) on a Connection (/diameter/connections). If radiusPendingTransactionsPerConnection is reached, then the Connection is not selected for routing until the pending transactions are below the radiusPendingTransactionPerConnection value. Typical value is 1000.",
"maximum": 5000,
"minimum": 1,
"type": "integer"
},
"radiusPreventDuplicateEgressRetransmission": {
"description": "radiusPreventDuplicateEgressRetransmission applies to RADIUS client Connections (/diameter/connections) only and determines how to handle a request message being retransmitted to the same Peer Node (/diameter/peernodes) as before, but the corresponding transaction record (that contains the previously used source port, RADIUS Id, and request authenticator) has expired. If rediusPreventDuplicateEgressRetransmission is true, and if the corresponding transaction record has expired, the DSR does not forward the message to the same Peer Node (/diameter/peernodes) with a new RADIUS Id, source port, and request authenticator. An alternate Peer Node can be selected for routing in this case. If radiusPreventDuplicateEgressRetransmission is false, and the corresponding transaction record has expired, DSR selects a new source port, RADIUS Id, and request authenticator; creates a new transaction record; and forwards the message to the Peer Node. Typical value is true.",
"type": "boolean"
},
"radiusPreventDuplicateIngressRetransmission": {
"description": "radiusPreventDuplicateIngressRetransmission applies to RADIUS server Connections (/diameter/connections) only and determines how DSR processes duplicate request messages received from a client. A request is considered duplicate if the client retransmits a request message with the same source IP address, source port number, RADIUS Id, and request authenticator. If radiusPreventDuplicateIngressRetransmission is true, DSR creates an ingress transaction record for the message (with the message's source IP address, port, RADIUS Id, and request authenticator), which is used to admit only the first message into DSR and prevent admitting duplicate requests, if received, until the transaction record is present. If an egress message has been sent to the Peer Node (/diameter/peernodes) previously, it is saved in the transaction record and is forwarded to the client in response to duplicate requests. If radiusPreventDuplicateIngressRetransmission is false, DSR does not maintain ingress transaction records and admits all messages received from the client. Typical value is true.",
"type": "boolean"
},
"sctpDatagramBundlingEnabled": {
"description": "If true, datagram bundling is enable for the SCTP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Peer Node (/diameter/peernodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Peer Node (/diameter/peernodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the DSR rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/diameter/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, DSR fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when an Connection (/diameter/connections) is started but the roundtrip time has not yet been measured. DSR uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm DSR uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the DSR rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpKeepAliveEnabled": {
"description": "If true, DSR probes a TCP Connection (/diameter/connections) that has been idle for the time configured in tcpKeepAliveIdleTime. Typical value is false.",
"type": "boolean"
},
"tcpKeepAliveIdleTime": {
"description": "Specifies the number of seconds of idle time between keep alive probes if tcpKeepAliveEnabled is set to true. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 7200,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveMaximumCount": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveMaximumCount sets the maximum number of keep alive probes DSR sends without any response from the remote server before DSR gives up and aborts the Connection (/diameter/connections). Typical value is 9. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveProbeInterval": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveProbeInterval sets the interval between keep alive probes in seconds. This value cannot be changed after a Connection (/diameter/connections) is established. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 120,
"minimum": 1,
"type": "integer"
},
"tcpMaximumSegmentSize": {
"description": "The tcpMaximumSegmentSize (in bytes) is the IP maximum transmission unit minus the size of the TCP, and IPv4 or IPv6 headers for outgoing TCP packets. A value of zero indicates no limit on a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 1024.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"tcpNagleEnabled": {
"description": "If true, the Nagle algorithm is enabled for the TCP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"tcpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming TCP messages. The receive buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing TCP messages. The send buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"diameterCexHostIpValidationEnabled",
"diameterCexTimer",
"diameterDisconnectTimer",
"diameterPendingTransactionsPerConnection",
"diameterProvingDeviceWatchdogRequestsToSend",
"diameterProvingMode",
"diameterProvingTimeout",
"diameterTransportConnectionTimer",
"diameterWatchdogTimerInitValue",
"name",
"radiusCachedResponseDuration",
"radiusPendingTransactionsPerConnection",
"radiusPreventDuplicateEgressRetransmission",
"radiusPreventDuplicateIngressRetransmission",
"sctpDatagramBundlingEnabled",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize",
"tcpKeepAliveEnabled",
"tcpKeepAliveIdleTime",
"tcpKeepAliveMaximumCount",
"tcpKeepAliveProbeInterval",
"tcpMaximumSegmentSize",
"tcpNagleEnabled",
"tcpSocketReceiveSize",
"tcpSocketSendSize"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "52",
"diameterCexHostIpValidationEnabled": true,
"diameterCexTimer": 3,
"diameterDisconnectTimer": 3,
"diameterPendingTransactionsPerConnection": 1000,
"diameterProvingDeviceWatchdogRequestsToSend": 3,
"diameterProvingMode": "Suspect",
"diameterProvingTimeout": 500,
"diameterTransportConnectionTimer": 30,
"diameterWatchdogTimerInitValue": 30,
"name": "ConnectionConfigurationSet1",
"radiusCachedResponseDuration": 5000,
"radiusPendingTransactionsPerConnection": 1000,
"radiusPreventDuplicateEgressRetransmission": true,
"radiusPreventDuplicateIngressRetransmission": true,
"sctpDatagramBundlingEnabled": true,
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000,
"tcpKeepAliveEnabled": true,
"tcpKeepAliveIdleTime": 1,
"tcpKeepAliveMaximumCount": 9,
"tcpKeepAliveProbeInterval": 1,
"tcpMaximumSegmentSize": 1024,
"tcpNagleEnabled": true,
"tcpSocketReceiveSize": 1000000,
"tcpSocketSendSize": 1000000
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/connectionconfigurationsets
Adds a new Connection Configuration Set to the DSR configuration. The Connection Configuration Set name must be unique across all Connection Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"cl1MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 4 and the range is 1-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 1 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"cl2MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL2. The typical value is 8 and the range is 2-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 2 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 2,
"type": "integer"
},
"cl3MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 16 and the range is 3-16 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 3 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 16,
"minimum": 3,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diameterCexHostIpValidationEnabled": {
"description": "If true, Host-IP-Address AVP validation is enabled during CEX message exchange. Typical value is true.",
"type": "boolean"
},
"diameterCexTimer": {
"description": "Time (in seconds) to wait on a Capabilities Exchange Request message from a Peer Node (/diameter/peernodes) after a Connection (/diameter/connections) is initiated by the Peer Node; and time to wait on a Capabilities Exchange Answer response from a Peer Node after sending the request message. For Local Nodes (/diameter/localnodes), Capabilities Exchange Answer messages are sent in response to erroneous Capabilities Exchange Request messages. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterDisconnectTimer": {
"description": "After sending a disconnect peer request message, time (in seconds) to wait for a Peer Node (/diameter/peernodes) to disconnect the Connection (/diameter/connections); and after sending a disconnect peer request message, time to wait for the Peer Node to send the answer message. If the diameterDisconnectTimer expires, the Connection is disconnected by the application. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for answer messages from the Peer Node (/diameter/peernodes) on this Connection (/diameter/connections). If the maximum is reached, this Connection is not selected for routing until the number of pending requests falls below this value. The diameterPendingTransactionsPerConnection value cannot be edited unless the Connection is disabled. Typical value is 1000.",
"maximum": 20000,
"minimum": 1,
"type": "integer"
},
"diameterProvingDeviceWatchdogRequestsToSend": {
"description": "The number of consecutive Device Watchdog Request and Answer message exchanges within a Proving Time interval during Connection (/diameter/connections) proving. Typical value is 3.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"diameterProvingMode": {
"description": "Proving mode for the Configuration Set. When set to Always, Device Watchdog Request and Answer exchanges are always done during Connection (/diameter/connections) proving. Suspect proving mode is only done when a Connection goes down due to an ungraceful disconnection (for example, no Disconnect Peer Request and Answer were exchanged when the Connection went down) and the Connection comes back up after the disconnection. When set to Never, proving is never done when a Connection goes down with the Peer Node (/diameter/peernodes) and it comes back up after a disconnection. Typical value is Suspect.",
"enum": [
"Always",
"Suspect",
"Never"
],
"type": "string"
},
"diameterProvingTimeout": {
"description": "The time (in milliseconds) to wait for a Peer Node (/diameter/peernodes) to send a Device Watchdog Answer message in response to a Device Watchdog Request message during Connection (/diameter/connections) proving. Typical value is 500.",
"maximum": 30000,
"minimum": 50,
"type": "integer"
},
"diameterTransportConnectionTimer": {
"description": "Controls the frequency (in seconds) that Connection (/diameter/connections) attempts are done to a Peer Node (/diameter/peernodes) where no active Connection exists. Applicable only for Connections configured to initiate a Connection with a Peer Node. Typical value is 30.",
"maximum": 60,
"minimum": 1,
"type": "integer"
},
"diameterWatchdogTimerInitValue": {
"description": "Initial value (in seconds) of the application watchdog timer. Typical value is 30.",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name associated with the Connection Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusCachedResponseDuration": {
"description": "Specifies the duration (in milliseconds) for which a cached response is held in the ingress transaction record. The radiusCachedResponseDuration value should cover the potential of loss of response and further retransmissions by the client. The radiusCachedResponseDuration applies only to server Connections (/diameter/connections) and only if radiusPreventDuplicateIngressRetransmission is true. Typical value is 5000.",
"maximum": 10000,
"minimum": 3000,
"type": "integer"
},
"radiusPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for a response from a Peer Node (/diameter/peernodes) on a Connection (/diameter/connections). If radiusPendingTransactionsPerConnection is reached, then the Connection is not selected for routing until the pending transactions are below the radiusPendingTransactionPerConnection value. Typical value is 1000.",
"maximum": 5000,
"minimum": 1,
"type": "integer"
},
"radiusPreventDuplicateEgressRetransmission": {
"description": "radiusPreventDuplicateEgressRetransmission applies to RADIUS client Connections (/diameter/connections) only and determines how to handle a request message being retransmitted to the same Peer Node (/diameter/peernodes) as before, but the corresponding transaction record (that contains the previously used source port, RADIUS Id, and request authenticator) has expired. If rediusPreventDuplicateEgressRetransmission is true, and if the corresponding transaction record has expired, the DSR does not forward the message to the same Peer Node (/diameter/peernodes) with a new RADIUS Id, source port, and request authenticator. An alternate Peer Node can be selected for routing in this case. If radiusPreventDuplicateEgressRetransmission is false, and the corresponding transaction record has expired, DSR selects a new source port, RADIUS Id, and request authenticator; creates a new transaction record; and forwards the message to the Peer Node. Typical value is true.",
"type": "boolean"
},
"radiusPreventDuplicateIngressRetransmission": {
"description": "radiusPreventDuplicateIngressRetransmission applies to RADIUS server Connections (/diameter/connections) only and determines how DSR processes duplicate request messages received from a client. A request is considered duplicate if the client retransmits a request message with the same source IP address, source port number, RADIUS Id, and request authenticator. If radiusPreventDuplicateIngressRetransmission is true, DSR creates an ingress transaction record for the message (with the message's source IP address, port, RADIUS Id, and request authenticator), which is used to admit only the first message into DSR and prevent admitting duplicate requests, if received, until the transaction record is present. If an egress message has been sent to the Peer Node (/diameter/peernodes) previously, it is saved in the transaction record and is forwarded to the client in response to duplicate requests. If radiusPreventDuplicateIngressRetransmission is false, DSR does not maintain ingress transaction records and admits all messages received from the client. Typical value is true.",
"type": "boolean"
},
"sctpDatagramBundlingEnabled": {
"description": "If true, datagram bundling is enable for the SCTP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Peer Node (/diameter/peernodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Peer Node (/diameter/peernodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the DSR rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/diameter/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, DSR fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when an Connection (/diameter/connections) is started but the roundtrip time has not yet been measured. DSR uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm DSR uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the DSR rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpKeepAliveEnabled": {
"description": "If true, DSR probes a TCP Connection (/diameter/connections) that has been idle for the time configured in tcpKeepAliveIdleTime. Typical value is false.",
"type": "boolean"
},
"tcpKeepAliveIdleTime": {
"description": "Specifies the number of seconds of idle time between keep alive probes if tcpKeepAliveEnabled is set to true. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 7200,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveMaximumCount": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveMaximumCount sets the maximum number of keep alive probes DSR sends without any response from the remote server before DSR gives up and aborts the Connection (/diameter/connections). Typical value is 9. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveProbeInterval": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveProbeInterval sets the interval between keep alive probes in seconds. This value cannot be changed after a Connection (/diameter/connections) is established. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 120,
"minimum": 1,
"type": "integer"
},
"tcpMaximumSegmentSize": {
"description": "The tcpMaximumSegmentSize (in bytes) is the IP maximum transmission unit minus the size of the TCP, and IPv4 or IPv6 headers for outgoing TCP packets. A value of zero indicates no limit on a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 1024.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"tcpNagleEnabled": {
"description": "If true, the Nagle algorithm is enabled for the TCP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"tcpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming TCP messages. The receive buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing TCP messages. The send buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"diameterCexHostIpValidationEnabled",
"diameterCexTimer",
"diameterDisconnectTimer",
"diameterPendingTransactionsPerConnection",
"diameterProvingDeviceWatchdogRequestsToSend",
"diameterProvingMode",
"diameterProvingTimeout",
"diameterTransportConnectionTimer",
"diameterWatchdogTimerInitValue",
"name",
"radiusCachedResponseDuration",
"radiusPendingTransactionsPerConnection",
"radiusPreventDuplicateEgressRetransmission",
"radiusPreventDuplicateIngressRetransmission",
"sctpDatagramBundlingEnabled",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize",
"tcpKeepAliveEnabled",
"tcpKeepAliveIdleTime",
"tcpKeepAliveMaximumCount",
"tcpKeepAliveProbeInterval",
"tcpMaximumSegmentSize",
"tcpNagleEnabled",
"tcpSocketReceiveSize",
"tcpSocketSendSize"
],
"type": "object"
}
Example
{
"configurationLevel": "52",
"diameterCexHostIpValidationEnabled": true,
"diameterCexTimer": 3,
"diameterDisconnectTimer": 3,
"diameterPendingTransactionsPerConnection": 1000,
"diameterProvingDeviceWatchdogRequestsToSend": 3,
"diameterProvingMode": "Suspect",
"diameterProvingTimeout": 500,
"diameterTransportConnectionTimer": 30,
"diameterWatchdogTimerInitValue": 30,
"name": "ConnectionConfigurationSet1",
"radiusCachedResponseDuration": 5000,
"radiusPendingTransactionsPerConnection": 1000,
"radiusPreventDuplicateEgressRetransmission": true,
"radiusPreventDuplicateIngressRetransmission": true,
"sctpDatagramBundlingEnabled": true,
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000,
"tcpKeepAliveEnabled": true,
"tcpKeepAliveIdleTime": 1,
"tcpKeepAliveMaximumCount": 9,
"tcpKeepAliveProbeInterval": 1,
"tcpMaximumSegmentSize": 1024,
"tcpNagleEnabled": true,
"tcpSocketReceiveSize": 1000000,
"tcpSocketSendSize": 1000000
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/connectionconfigurationsets/{name}
get /diameter/connectionconfigurationsets/{name}
Returns the configuration details for the specified Connection Configuration Set. If the Connection Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/connectionconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"cl1MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 4 and the range is 1-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 1 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"cl2MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL2. The typical value is 8 and the range is 2-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 2 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 2,
"type": "integer"
},
"cl3MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 16 and the range is 3-16 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 3 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 16,
"minimum": 3,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diameterCexHostIpValidationEnabled": {
"description": "If true, Host-IP-Address AVP validation is enabled during CEX message exchange. Typical value is true.",
"type": "boolean"
},
"diameterCexTimer": {
"description": "Time (in seconds) to wait on a Capabilities Exchange Request message from a Peer Node (/diameter/peernodes) after a Connection (/diameter/connections) is initiated by the Peer Node; and time to wait on a Capabilities Exchange Answer response from a Peer Node after sending the request message. For Local Nodes (/diameter/localnodes), Capabilities Exchange Answer messages are sent in response to erroneous Capabilities Exchange Request messages. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterDisconnectTimer": {
"description": "After sending a disconnect peer request message, time (in seconds) to wait for a Peer Node (/diameter/peernodes) to disconnect the Connection (/diameter/connections); and after sending a disconnect peer request message, time to wait for the Peer Node to send the answer message. If the diameterDisconnectTimer expires, the Connection is disconnected by the application. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for answer messages from the Peer Node (/diameter/peernodes) on this Connection (/diameter/connections). If the maximum is reached, this Connection is not selected for routing until the number of pending requests falls below this value. The diameterPendingTransactionsPerConnection value cannot be edited unless the Connection is disabled. Typical value is 1000.",
"maximum": 20000,
"minimum": 1,
"type": "integer"
},
"diameterProvingDeviceWatchdogRequestsToSend": {
"description": "The number of consecutive Device Watchdog Request and Answer message exchanges within a Proving Time interval during Connection (/diameter/connections) proving. Typical value is 3.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"diameterProvingMode": {
"description": "Proving mode for the Configuration Set. When set to Always, Device Watchdog Request and Answer exchanges are always done during Connection (/diameter/connections) proving. Suspect proving mode is only done when a Connection goes down due to an ungraceful disconnection (for example, no Disconnect Peer Request and Answer were exchanged when the Connection went down) and the Connection comes back up after the disconnection. When set to Never, proving is never done when a Connection goes down with the Peer Node (/diameter/peernodes) and it comes back up after a disconnection. Typical value is Suspect.",
"enum": [
"Always",
"Suspect",
"Never"
],
"type": "string"
},
"diameterProvingTimeout": {
"description": "The time (in milliseconds) to wait for a Peer Node (/diameter/peernodes) to send a Device Watchdog Answer message in response to a Device Watchdog Request message during Connection (/diameter/connections) proving. Typical value is 500.",
"maximum": 30000,
"minimum": 50,
"type": "integer"
},
"diameterTransportConnectionTimer": {
"description": "Controls the frequency (in seconds) that Connection (/diameter/connections) attempts are done to a Peer Node (/diameter/peernodes) where no active Connection exists. Applicable only for Connections configured to initiate a Connection with a Peer Node. Typical value is 30.",
"maximum": 60,
"minimum": 1,
"type": "integer"
},
"diameterWatchdogTimerInitValue": {
"description": "Initial value (in seconds) of the application watchdog timer. Typical value is 30.",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name associated with the Connection Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusCachedResponseDuration": {
"description": "Specifies the duration (in milliseconds) for which a cached response is held in the ingress transaction record. The radiusCachedResponseDuration value should cover the potential of loss of response and further retransmissions by the client. The radiusCachedResponseDuration applies only to server Connections (/diameter/connections) and only if radiusPreventDuplicateIngressRetransmission is true. Typical value is 5000.",
"maximum": 10000,
"minimum": 3000,
"type": "integer"
},
"radiusPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for a response from a Peer Node (/diameter/peernodes) on a Connection (/diameter/connections). If radiusPendingTransactionsPerConnection is reached, then the Connection is not selected for routing until the pending transactions are below the radiusPendingTransactionPerConnection value. Typical value is 1000.",
"maximum": 5000,
"minimum": 1,
"type": "integer"
},
"radiusPreventDuplicateEgressRetransmission": {
"description": "radiusPreventDuplicateEgressRetransmission applies to RADIUS client Connections (/diameter/connections) only and determines how to handle a request message being retransmitted to the same Peer Node (/diameter/peernodes) as before, but the corresponding transaction record (that contains the previously used source port, RADIUS Id, and request authenticator) has expired. If rediusPreventDuplicateEgressRetransmission is true, and if the corresponding transaction record has expired, the DSR does not forward the message to the same Peer Node (/diameter/peernodes) with a new RADIUS Id, source port, and request authenticator. An alternate Peer Node can be selected for routing in this case. If radiusPreventDuplicateEgressRetransmission is false, and the corresponding transaction record has expired, DSR selects a new source port, RADIUS Id, and request authenticator; creates a new transaction record; and forwards the message to the Peer Node. Typical value is true.",
"type": "boolean"
},
"radiusPreventDuplicateIngressRetransmission": {
"description": "radiusPreventDuplicateIngressRetransmission applies to RADIUS server Connections (/diameter/connections) only and determines how DSR processes duplicate request messages received from a client. A request is considered duplicate if the client retransmits a request message with the same source IP address, source port number, RADIUS Id, and request authenticator. If radiusPreventDuplicateIngressRetransmission is true, DSR creates an ingress transaction record for the message (with the message's source IP address, port, RADIUS Id, and request authenticator), which is used to admit only the first message into DSR and prevent admitting duplicate requests, if received, until the transaction record is present. If an egress message has been sent to the Peer Node (/diameter/peernodes) previously, it is saved in the transaction record and is forwarded to the client in response to duplicate requests. If radiusPreventDuplicateIngressRetransmission is false, DSR does not maintain ingress transaction records and admits all messages received from the client. Typical value is true.",
"type": "boolean"
},
"sctpDatagramBundlingEnabled": {
"description": "If true, datagram bundling is enable for the SCTP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Peer Node (/diameter/peernodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Peer Node (/diameter/peernodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the DSR rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/diameter/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, DSR fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when an Connection (/diameter/connections) is started but the roundtrip time has not yet been measured. DSR uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm DSR uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the DSR rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpKeepAliveEnabled": {
"description": "If true, DSR probes a TCP Connection (/diameter/connections) that has been idle for the time configured in tcpKeepAliveIdleTime. Typical value is false.",
"type": "boolean"
},
"tcpKeepAliveIdleTime": {
"description": "Specifies the number of seconds of idle time between keep alive probes if tcpKeepAliveEnabled is set to true. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 7200,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveMaximumCount": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveMaximumCount sets the maximum number of keep alive probes DSR sends without any response from the remote server before DSR gives up and aborts the Connection (/diameter/connections). Typical value is 9. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveProbeInterval": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveProbeInterval sets the interval between keep alive probes in seconds. This value cannot be changed after a Connection (/diameter/connections) is established. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 120,
"minimum": 1,
"type": "integer"
},
"tcpMaximumSegmentSize": {
"description": "The tcpMaximumSegmentSize (in bytes) is the IP maximum transmission unit minus the size of the TCP, and IPv4 or IPv6 headers for outgoing TCP packets. A value of zero indicates no limit on a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 1024.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"tcpNagleEnabled": {
"description": "If true, the Nagle algorithm is enabled for the TCP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"tcpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming TCP messages. The receive buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing TCP messages. The send buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"diameterCexHostIpValidationEnabled",
"diameterCexTimer",
"diameterDisconnectTimer",
"diameterPendingTransactionsPerConnection",
"diameterProvingDeviceWatchdogRequestsToSend",
"diameterProvingMode",
"diameterProvingTimeout",
"diameterTransportConnectionTimer",
"diameterWatchdogTimerInitValue",
"name",
"radiusCachedResponseDuration",
"radiusPendingTransactionsPerConnection",
"radiusPreventDuplicateEgressRetransmission",
"radiusPreventDuplicateIngressRetransmission",
"sctpDatagramBundlingEnabled",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize",
"tcpKeepAliveEnabled",
"tcpKeepAliveIdleTime",
"tcpKeepAliveMaximumCount",
"tcpKeepAliveProbeInterval",
"tcpMaximumSegmentSize",
"tcpNagleEnabled",
"tcpSocketReceiveSize",
"tcpSocketSendSize"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "52",
"diameterCexHostIpValidationEnabled": true,
"diameterCexTimer": 3,
"diameterDisconnectTimer": 3,
"diameterPendingTransactionsPerConnection": 1000,
"diameterProvingDeviceWatchdogRequestsToSend": 3,
"diameterProvingMode": "Suspect",
"diameterProvingTimeout": 500,
"diameterTransportConnectionTimer": 30,
"diameterWatchdogTimerInitValue": 30,
"name": "ConnectionConfigurationSet1",
"radiusCachedResponseDuration": 5000,
"radiusPendingTransactionsPerConnection": 1000,
"radiusPreventDuplicateEgressRetransmission": true,
"radiusPreventDuplicateIngressRetransmission": true,
"sctpDatagramBundlingEnabled": true,
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000,
"tcpKeepAliveEnabled": true,
"tcpKeepAliveIdleTime": 1,
"tcpKeepAliveMaximumCount": 9,
"tcpKeepAliveProbeInterval": 1,
"tcpMaximumSegmentSize": 1024,
"tcpNagleEnabled": true,
"tcpSocketReceiveSize": 1000000,
"tcpSocketSendSize": 1000000
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/connectionconfigurationsets/{name}
Updates the configuration of the specified Connection Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"cl1MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 4 and the range is 1-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 1 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"cl2MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL2. The typical value is 8 and the range is 2-15 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 2 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 15,
"minimum": 2,
"type": "integer"
},
"cl3MinPriorityAllowed": {
"description": "Defines the minimum message priority of a Request message that can be forwarded to a Connection (/diameter/connections) whose congestion level is CL1. The typical value is 16 and the range is 3-16 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to true. The typical value is 3 when the ngnPs16PriorityAdminStateEnabled value (/diameter/options) is set to false.",
"maximum": 16,
"minimum": 3,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diameterCexHostIpValidationEnabled": {
"description": "If true, Host-IP-Address AVP validation is enabled during CEX message exchange. Typical value is true.",
"type": "boolean"
},
"diameterCexTimer": {
"description": "Time (in seconds) to wait on a Capabilities Exchange Request message from a Peer Node (/diameter/peernodes) after a Connection (/diameter/connections) is initiated by the Peer Node; and time to wait on a Capabilities Exchange Answer response from a Peer Node after sending the request message. For Local Nodes (/diameter/localnodes), Capabilities Exchange Answer messages are sent in response to erroneous Capabilities Exchange Request messages. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterDisconnectTimer": {
"description": "After sending a disconnect peer request message, time (in seconds) to wait for a Peer Node (/diameter/peernodes) to disconnect the Connection (/diameter/connections); and after sending a disconnect peer request message, time to wait for the Peer Node to send the answer message. If the diameterDisconnectTimer expires, the Connection is disconnected by the application. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"diameterPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for answer messages from the Peer Node (/diameter/peernodes) on this Connection (/diameter/connections). If the maximum is reached, this Connection is not selected for routing until the number of pending requests falls below this value. The diameterPendingTransactionsPerConnection value cannot be edited unless the Connection is disabled. Typical value is 1000.",
"maximum": 20000,
"minimum": 1,
"type": "integer"
},
"diameterProvingDeviceWatchdogRequestsToSend": {
"description": "The number of consecutive Device Watchdog Request and Answer message exchanges within a Proving Time interval during Connection (/diameter/connections) proving. Typical value is 3.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"diameterProvingMode": {
"description": "Proving mode for the Configuration Set. When set to Always, Device Watchdog Request and Answer exchanges are always done during Connection (/diameter/connections) proving. Suspect proving mode is only done when a Connection goes down due to an ungraceful disconnection (for example, no Disconnect Peer Request and Answer were exchanged when the Connection went down) and the Connection comes back up after the disconnection. When set to Never, proving is never done when a Connection goes down with the Peer Node (/diameter/peernodes) and it comes back up after a disconnection. Typical value is Suspect.",
"enum": [
"Always",
"Suspect",
"Never"
],
"type": "string"
},
"diameterProvingTimeout": {
"description": "The time (in milliseconds) to wait for a Peer Node (/diameter/peernodes) to send a Device Watchdog Answer message in response to a Device Watchdog Request message during Connection (/diameter/connections) proving. Typical value is 500.",
"maximum": 30000,
"minimum": 50,
"type": "integer"
},
"diameterTransportConnectionTimer": {
"description": "Controls the frequency (in seconds) that Connection (/diameter/connections) attempts are done to a Peer Node (/diameter/peernodes) where no active Connection exists. Applicable only for Connections configured to initiate a Connection with a Peer Node. Typical value is 30.",
"maximum": 60,
"minimum": 1,
"type": "integer"
},
"diameterWatchdogTimerInitValue": {
"description": "Initial value (in seconds) of the application watchdog timer. Typical value is 30.",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name associated with the Connection Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusCachedResponseDuration": {
"description": "Specifies the duration (in milliseconds) for which a cached response is held in the ingress transaction record. The radiusCachedResponseDuration value should cover the potential of loss of response and further retransmissions by the client. The radiusCachedResponseDuration applies only to server Connections (/diameter/connections) and only if radiusPreventDuplicateIngressRetransmission is true. Typical value is 5000.",
"maximum": 10000,
"minimum": 3000,
"type": "integer"
},
"radiusPendingTransactionsPerConnection": {
"description": "The maximum number of pending request messages waiting for a response from a Peer Node (/diameter/peernodes) on a Connection (/diameter/connections). If radiusPendingTransactionsPerConnection is reached, then the Connection is not selected for routing until the pending transactions are below the radiusPendingTransactionPerConnection value. Typical value is 1000.",
"maximum": 5000,
"minimum": 1,
"type": "integer"
},
"radiusPreventDuplicateEgressRetransmission": {
"description": "radiusPreventDuplicateEgressRetransmission applies to RADIUS client Connections (/diameter/connections) only and determines how to handle a request message being retransmitted to the same Peer Node (/diameter/peernodes) as before, but the corresponding transaction record (that contains the previously used source port, RADIUS Id, and request authenticator) has expired. If rediusPreventDuplicateEgressRetransmission is true, and if the corresponding transaction record has expired, the DSR does not forward the message to the same Peer Node (/diameter/peernodes) with a new RADIUS Id, source port, and request authenticator. An alternate Peer Node can be selected for routing in this case. If radiusPreventDuplicateEgressRetransmission is false, and the corresponding transaction record has expired, DSR selects a new source port, RADIUS Id, and request authenticator; creates a new transaction record; and forwards the message to the Peer Node. Typical value is true.",
"type": "boolean"
},
"radiusPreventDuplicateIngressRetransmission": {
"description": "radiusPreventDuplicateIngressRetransmission applies to RADIUS server Connections (/diameter/connections) only and determines how DSR processes duplicate request messages received from a client. A request is considered duplicate if the client retransmits a request message with the same source IP address, source port number, RADIUS Id, and request authenticator. If radiusPreventDuplicateIngressRetransmission is true, DSR creates an ingress transaction record for the message (with the message's source IP address, port, RADIUS Id, and request authenticator), which is used to admit only the first message into DSR and prevent admitting duplicate requests, if received, until the transaction record is present. If an egress message has been sent to the Peer Node (/diameter/peernodes) previously, it is saved in the transaction record and is forwarded to the client in response to duplicate requests. If radiusPreventDuplicateIngressRetransmission is false, DSR does not maintain ingress transaction records and admits all messages received from the client. Typical value is true.",
"type": "boolean"
},
"sctpDatagramBundlingEnabled": {
"description": "If true, datagram bundling is enable for the SCTP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Peer Node (/diameter/peernodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Peer Node (/diameter/peernodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the DSR rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/diameter/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, DSR fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/diameter/connections). Typical value is 8.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when an Connection (/diameter/connections) is started but the roundtrip time has not yet been measured. DSR uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm DSR uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the DSR rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/diameter/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpKeepAliveEnabled": {
"description": "If true, DSR probes a TCP Connection (/diameter/connections) that has been idle for the time configured in tcpKeepAliveIdleTime. Typical value is false.",
"type": "boolean"
},
"tcpKeepAliveIdleTime": {
"description": "Specifies the number of seconds of idle time between keep alive probes if tcpKeepAliveEnabled is set to true. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 7200,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveMaximumCount": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveMaximumCount sets the maximum number of keep alive probes DSR sends without any response from the remote server before DSR gives up and aborts the Connection (/diameter/connections). Typical value is 9. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"tcpKeepAliveProbeInterval": {
"description": "If tcpKeepAliveEnabled is true, tcpKeepAliveProbeInterval sets the interval between keep alive probes in seconds. This value cannot be changed after a Connection (/diameter/connections) is established. Typical value is 1. Only applies when tcpKeepAliveEnabled is true.",
"maximum": 120,
"minimum": 1,
"type": "integer"
},
"tcpMaximumSegmentSize": {
"description": "The tcpMaximumSegmentSize (in bytes) is the IP maximum transmission unit minus the size of the TCP, and IPv4 or IPv6 headers for outgoing TCP packets. A value of zero indicates no limit on a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the DSR rejects values between 1 and 87, inclusive. Typical value is 1024.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"tcpNagleEnabled": {
"description": "If true, the Nagle algorithm is enabled for the TCP Connection (/diameter/connections). Typical value is true.",
"type": "boolean"
},
"tcpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming TCP messages. The receive buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"tcpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing TCP messages. The send buffer size should be greater than or equal to the product of the bandwidth and the round trip delay for the Connection (/diameter/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"diameterCexHostIpValidationEnabled",
"diameterCexTimer",
"diameterDisconnectTimer",
"diameterPendingTransactionsPerConnection",
"diameterProvingDeviceWatchdogRequestsToSend",
"diameterProvingMode",
"diameterProvingTimeout",
"diameterTransportConnectionTimer",
"diameterWatchdogTimerInitValue",
"name",
"radiusCachedResponseDuration",
"radiusPendingTransactionsPerConnection",
"radiusPreventDuplicateEgressRetransmission",
"radiusPreventDuplicateIngressRetransmission",
"sctpDatagramBundlingEnabled",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize",
"tcpKeepAliveEnabled",
"tcpKeepAliveIdleTime",
"tcpKeepAliveMaximumCount",
"tcpKeepAliveProbeInterval",
"tcpMaximumSegmentSize",
"tcpNagleEnabled",
"tcpSocketReceiveSize",
"tcpSocketSendSize"
],
"type": "object"
}
Example
{
"configurationLevel": "52",
"diameterCexHostIpValidationEnabled": true,
"diameterCexTimer": 3,
"diameterDisconnectTimer": 3,
"diameterPendingTransactionsPerConnection": 1000,
"diameterProvingDeviceWatchdogRequestsToSend": 3,
"diameterProvingMode": "Suspect",
"diameterProvingTimeout": 500,
"diameterTransportConnectionTimer": 30,
"diameterWatchdogTimerInitValue": 30,
"name": "ConnectionConfigurationSet1",
"radiusCachedResponseDuration": 5000,
"radiusPendingTransactionsPerConnection": 1000,
"radiusPreventDuplicateEgressRetransmission": true,
"radiusPreventDuplicateIngressRetransmission": true,
"sctpDatagramBundlingEnabled": true,
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000,
"tcpKeepAliveEnabled": true,
"tcpKeepAliveIdleTime": 1,
"tcpKeepAliveMaximumCount": 9,
"tcpKeepAliveProbeInterval": 1,
"tcpMaximumSegmentSize": 1024,
"tcpNagleEnabled": true,
"tcpSocketReceiveSize": 1000000,
"tcpSocketSendSize": 1000000
}
delete /diameter/connectionconfigurationsets/{name}
Deletes the specified Connection Configuration Set from the SOAM configuration. The Default Connection Configuration Set cannot be deleted. A Connection Configuration Set can only be deleted if all delete validation checks pass. In general, if the Connection Configuration Set is a part of the configuration of one or more Connections (/diameter/connections) or Local Nodes (/diameter/localnodes), the Connection Configuration Set cannot be deleted. If the Connection Configuration Set is named in a Connection or Local Node, the Connection Configuration Set must first be removed from the Connection or Local Node. Then the Connection Configuration Set can be deleted from the configuration. An attempt to delete a Connection Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Connections
A Connection encapsulates details of the transport layer connectivity and some Diameter characteristics between a Local Node (/diameter/localnodes) and a specific Peer Node (/diameter/peernodes). The transport protocol (TCP, SCTP, TLS/TCP, DTLS/SCTP, UDP) is configured for the Connection, as well as the IP address(s) at both the local and peer ends.
Each Connection supports Diameter messages or RADIUS messages, but not both.
All Connection configuration is done at the SOAM.
/diameter/connections
get /diameter/connections
Returns all Connections configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Connections meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Connections.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/connectionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connection.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Connection, which defines the Connection as either Diameter or Radius. This value is required for all Connections, and cannot be changed after the Connection is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"capacityCfgSetName": {
"description": "The Capacity Configuration Set (/diameter/capacityconfigurationsets) defines reserved and maximum ingress message processing rates and alarm thresholds for this connection. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/capabilitiesexchangeconfigurationsets) assigned to a Connection supplies capabilities exchange parameters used during connection establishment. Diameter Connections only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Connection supplies default values for a variety of transport connection parameters. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "Defines the connection initiation behavior of this Connection. LocalMpInitiator, LocalMpResponder, and FullySpecified apply only to Diameter Connections, while RadiusServer and RadiusClient only apply to RADIUS Connections. LocalMpInitiator means the Local Node (/diameter/localnodes) initiates a connection attempt to the Peer Node (/diameter/peernodes). LocalMpResponder means the Local Node does not initiate a connection attempt to the Peer Node, but only responds to a connection attempt initiated by the Peer Node. FullySpecified means the Local Node initiates a connection attempt, as well as responding to connection attempts initiated by the Peer Node. RadiusServer means the Local Node receives incoming RADIUS requests from a Peer Node configured as a RADIUS client. RadiusClient means the Local Node sends RADIUS requests to a Peer Node configured as a RADIUS server. This value is required for all Connections.",
"enum": [
"FullySpecified",
"LocalMpInitiator",
"LocalMpResponder",
"RadiusServer",
"RadiusClient"
],
"type": "string"
},
"ipfeInitiatorDampIp": {
"description": "If this Connection is an IPFE Connection and can be an initiator, the IPFE Initiator DA-MP is the one DA-MP that initiates the Connection to the Peer Node. This property must therefore be an IP address configured to the DA-MP that initiates the Connection, and the DA-MP must belong to the Target Set whose address(es) are configured as the local IP address(es) for this Connection. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"isDynamic": {
"description": "If true, means the Connection was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Connections only.",
"readOnly": true,
"type": "boolean"
},
"localInitiatorPort": {
"description": "The source port from which the DSR sends a connection initiation request to the Peer Node (/diameter/peernodes). Diameter Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"localIp": {
"description": "The IP address to be used as the primary Local Node (/diameter/localnodes) address for this Connection. This IP address must be one of the IP addresses configured for the Local Node assigned to this Connection. This value is required for all Connections.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNodeName": {
"description": "Name of the Local Node (/diameter/localnodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgAuthCfgSetName": {
"description": "Name of the Message Authenticator Configuration Set (/diameter/messageauthenticatorconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgConvCfgSetName": {
"description": "Name of the Message Conversion Configuration Set (/diameter/messageconversionconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Connection supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when this Connection's Message Priority Setting is UserConfigured. Diameter Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a Request and this Connection's Message Priority Setting is set to None, then the Peer Node's (/diameter/peernodes) Message Priority Setting determines how priority is assigned to a Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to UserConfigured, the Message Priority Configuration Set assigned to this Connection is used to determine the priority of request messages received from the Peer Node. Diameter Connections only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"msgThrottlingCfgSetName": {
"description": "Name of the Message Throttling Configuration Set (/diameter/messagethrottlingconfigurationsets) associated with this Connection.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the Connection, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerIdentification": {
"description": "Specifies how the Local Node (/diameter/localnodes) derives the Peer Node's (/diameter/peernodes) IP address(es) when initiating a Connection to the Peer Node, and whether the Local Node validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When None is specified, DSR does not validate the Peer Node's IP address(s) when responding to a Connection from the Peer Node. When IP is specified, DSR uses the Peer Node's IP address(es) configured for this Connection when initiating a Connection to the Peer Node, and validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When TransportFqdn is specified, DSR uses the DNS-resolved Transport FQDN address configured for this Connection when initiating a connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When PeerFqdn is specified, DSR uses the DNS-resolved FQDN address configured for the Peer Node associated with this Connection when initiating a Connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. This value is required for all Connections.",
"enum": [
"Ip",
"TransportFqdn",
"PeerFqdn",
"None"
],
"type": "string"
},
"peerIp": {
"description": "The IP address to be used as the primary Peer Node (/diameter/peernodes) address for this Connection. Required for RADIUS Connections. For Diameter Connections, required whenever peerIdentification is not IP. priPeerIp must be one of the IP addresses configured for the Peer Node assigned to this Connection.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteBusyTimeout": {
"description": "Defines the time period (in seconds) that a Connection is considered BUSY from the last time a DIAMETER_TOO_BUSY response was received. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"remoteBusyUsage": {
"description": "Defines which Request messages can be forwarded on this Connection after receiving a DIAMETER_TOO_BUSY response from the Connection's Peer Node (/diameter/peernodes). When set to false, the Connection is not considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. All Request messages continue to be forwarded to (or rerouted to) this Connection. When set to true, the Connection is considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. No Request messages can be forwarded to (or rerouted to) this Connection until the Remote Busy Abatement Timeout expires. Diameter Connections only.",
"type": "boolean"
},
"altLocalIp": {
"description": "The IP address to be used as the alternate Local Node (/diameter/localnodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary local IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"altPeerIp": {
"description": "The IP address to be used as the alternate Peer Node (/diameter/peernodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary peer IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"sharedSecretCfgSetName": {
"description": "Name of the Shared Secret Configuration Set (/diameter/sharedsecretconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerCfgSetName": {
"description": "Name of the Ingress Status-Server Configuration Set (/diameter/statusserverconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"suppressConnAttempt": {
"description": "If true, connection attempts to the standby Peer Node (/diameter/peernodes) are suppressed once the Peer Node's Operational Status is Available. Diameter Connections only. ",
"type": "boolean"
},
"suppressConnUnavailableAlarm": {
"description": "If true, a connection unavailable alarm is not raised for this Connection whenever the Connection becomes Unavailable. Diameter Connections only. ",
"type": "boolean"
},
"testMode": {
"description": "If true, indicates the Connection is in test mode. Diameter Connections only.",
"type": "boolean"
},
"transportCongTimeout": {
"description": "Defines the time period (in seconds) spent by the Connection in abating each congestion level during abatement. Typical value is 5 seconds. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"transportFqdn": {
"description": "Fully Qualified Domain Name for this Connection. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long. Diameter Connections only.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"transportProtocol": {
"description": "The transport protocol used by this Connection. The selected protocol must be supported by both the Local Node (/diameter/localnodes) and the Peer Node (/diameter/peernodes) assigned to this Connection. The transport protocols Tcp, Tls, Sctp, and Dtls may only be associated with Diameter Connections, while Udp may only be associated with RADIUS Connections. Required for all Connections. Note: The MP hosting this Connection should not have IPSEC enabled if this Connection is configured as Tls or Dtls, since enabling both IPSEC and TLS/TCP or DTLS/SCTP would have a significant, negative impact on Connection performance. This value is required for all Connections.",
"enum": [
"Sctp",
"Dtls",
"Tcp",
"Tls",
"Udp"
],
"type": "string"
},
"udpPort": {
"description": "For RADIUS Server Connections, this is the UDP port on which the DSR expects to receive incoming RADIUS requests for this Connection. For RADIUS Client Connections, this is the UDP port at the destination Peer Node (/diameter/peernodes), which receives the RADIUS request sent by the DSR. RADIUS Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"aaaProtocol",
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"localNodeName",
"name",
"peerIdentification",
"peerNodeName",
"localIp",
"transportProtocol"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"aaaProtocol": "Radius",
"altLocalIp": "10.24.5.42",
"altPeerIp": "52.36.25.63",
"capacityCfgSetName": "capCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"configurationLevel": "48",
"connCfgSetName": "connCfgSet1",
"connectionMode": "LocalMpResponder",
"isDynamic": false,
"localInitiatorPort": 6615,
"localIp": "10.24.2.8",
"localNodeName": "localNode1",
"msgConvCfgSetName": "msgConvCfgSet1",
"msgPriorityCfgSetName": "msgPriorityCfgSet1",
"msgPrioritySetting": "RequestMessage",
"name": "Connection1",
"peerIdentification": "Ip",
"peerIp": "52.36.41.9",
"peerNodeName": "peerNode1",
"remoteBusyTimeout": 30,
"remoteBusyUsage": true,
"statusServerCfgSetName": "statusServerCfgSet1",
"suppressConnAttempt": false,
"suppressConnUnavailableAlarm": true,
"testMode": false,
"transportFqdn": "transport.domain.com",
"transportProtocol": "Udp",
"udpPort": 42272
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/connections
Adds a new Connection to the DSR configuration. The new Connection must have a name that is unique across all Connections at the SOAM. For a given Peer Node (/diameter/peernodes), unique Connections can be configured for each combination of the following attributes: Local Node (/diameter/localnodes) IP address(es), Local Node Listen Port, transport protocol, Peer Node IP address(es), Peer Diameter Identity FQDN, Peer Realm, and must include Diameter Application IDs (/diameter/applicationids). If this set of Connection attributes is common for two or more Connections, then those Connections are considered part of the same Connection pool.
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Connections.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connection.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Connection, which defines the Connection as either Diameter or Radius. This value is required for all Connections, and cannot be changed after the Connection is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"capacityCfgSetName": {
"description": "The Capacity Configuration Set (/diameter/capacityconfigurationsets) defines reserved and maximum ingress message processing rates and alarm thresholds for this connection. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/capabilitiesexchangeconfigurationsets) assigned to a Connection supplies capabilities exchange parameters used during connection establishment. Diameter Connections only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Connection supplies default values for a variety of transport connection parameters. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "Defines the connection initiation behavior of this Connection. LocalMpInitiator, LocalMpResponder, and FullySpecified apply only to Diameter Connections, while RadiusServer and RadiusClient only apply to RADIUS Connections. LocalMpInitiator means the Local Node (/diameter/localnodes) initiates a connection attempt to the Peer Node (/diameter/peernodes). LocalMpResponder means the Local Node does not initiate a connection attempt to the Peer Node, but only responds to a connection attempt initiated by the Peer Node. FullySpecified means the Local Node initiates a connection attempt, as well as responding to connection attempts initiated by the Peer Node. RadiusServer means the Local Node receives incoming RADIUS requests from a Peer Node configured as a RADIUS client. RadiusClient means the Local Node sends RADIUS requests to a Peer Node configured as a RADIUS server. This value is required for all Connections.",
"enum": [
"FullySpecified",
"LocalMpInitiator",
"LocalMpResponder",
"RadiusServer",
"RadiusClient"
],
"type": "string"
},
"ipfeInitiatorDampIp": {
"description": "If this Connection is an IPFE Connection and can be an initiator, the IPFE Initiator DA-MP is the one DA-MP that initiates the Connection to the Peer Node. This property must therefore be an IP address configured to the DA-MP that initiates the Connection, and the DA-MP must belong to the Target Set whose address(es) are configured as the local IP address(es) for this Connection. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"isDynamic": {
"description": "If true, means the Connection was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Connections only.",
"readOnly": true,
"type": "boolean"
},
"localInitiatorPort": {
"description": "The source port from which the DSR sends a connection initiation request to the Peer Node (/diameter/peernodes). Diameter Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"localIp": {
"description": "The IP address to be used as the primary Local Node (/diameter/localnodes) address for this Connection. This IP address must be one of the IP addresses configured for the Local Node assigned to this Connection. This value is required for all Connections.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNodeName": {
"description": "Name of the Local Node (/diameter/localnodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgAuthCfgSetName": {
"description": "Name of the Message Authenticator Configuration Set (/diameter/messageauthenticatorconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgConvCfgSetName": {
"description": "Name of the Message Conversion Configuration Set (/diameter/messageconversionconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Connection supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when this Connection's Message Priority Setting is UserConfigured. Diameter Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a Request and this Connection's Message Priority Setting is set to None, then the Peer Node's (/diameter/peernodes) Message Priority Setting determines how priority is assigned to a Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to UserConfigured, the Message Priority Configuration Set assigned to this Connection is used to determine the priority of request messages received from the Peer Node. Diameter Connections only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"msgThrottlingCfgSetName": {
"description": "Name of the Message Throttling Configuration Set (/diameter/messagethrottlingconfigurationsets) associated with this Connection.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the Connection, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerIdentification": {
"description": "Specifies how the Local Node (/diameter/localnodes) derives the Peer Node's (/diameter/peernodes) IP address(es) when initiating a Connection to the Peer Node, and whether the Local Node validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When None is specified, DSR does not validate the Peer Node's IP address(s) when responding to a Connection from the Peer Node. When IP is specified, DSR uses the Peer Node's IP address(es) configured for this Connection when initiating a Connection to the Peer Node, and validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When TransportFqdn is specified, DSR uses the DNS-resolved Transport FQDN address configured for this Connection when initiating a connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When PeerFqdn is specified, DSR uses the DNS-resolved FQDN address configured for the Peer Node associated with this Connection when initiating a Connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. This value is required for all Connections.",
"enum": [
"Ip",
"TransportFqdn",
"PeerFqdn",
"None"
],
"type": "string"
},
"peerIp": {
"description": "The IP address to be used as the primary Peer Node (/diameter/peernodes) address for this Connection. Required for RADIUS Connections. For Diameter Connections, required whenever peerIdentification is not IP. priPeerIp must be one of the IP addresses configured for the Peer Node assigned to this Connection.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteBusyTimeout": {
"description": "Defines the time period (in seconds) that a Connection is considered BUSY from the last time a DIAMETER_TOO_BUSY response was received. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"remoteBusyUsage": {
"description": "Defines which Request messages can be forwarded on this Connection after receiving a DIAMETER_TOO_BUSY response from the Connection's Peer Node (/diameter/peernodes). When set to false, the Connection is not considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. All Request messages continue to be forwarded to (or rerouted to) this Connection. When set to true, the Connection is considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. No Request messages can be forwarded to (or rerouted to) this Connection until the Remote Busy Abatement Timeout expires. Diameter Connections only.",
"type": "boolean"
},
"altLocalIp": {
"description": "The IP address to be used as the alternate Local Node (/diameter/localnodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary local IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"altPeerIp": {
"description": "The IP address to be used as the alternate Peer Node (/diameter/peernodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary peer IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"sharedSecretCfgSetName": {
"description": "Name of the Shared Secret Configuration Set (/diameter/sharedsecretconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerCfgSetName": {
"description": "Name of the Ingress Status-Server Configuration Set (/diameter/statusserverconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"suppressConnAttempt": {
"description": "If true, connection attempts to the standby Peer Node (/diameter/peernodes) are suppressed once the Peer Node's Operational Status is Available. Diameter Connections only. ",
"type": "boolean"
},
"suppressConnUnavailableAlarm": {
"description": "If true, a connection unavailable alarm is not raised for this Connection whenever the Connection becomes Unavailable. Diameter Connections only. ",
"type": "boolean"
},
"testMode": {
"description": "If true, indicates the Connection is in test mode. Diameter Connections only.",
"type": "boolean"
},
"transportCongTimeout": {
"description": "Defines the time period (in seconds) spent by the Connection in abating each congestion level during abatement. Typical value is 5 seconds. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"transportFqdn": {
"description": "Fully Qualified Domain Name for this Connection. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long. Diameter Connections only.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"transportProtocol": {
"description": "The transport protocol used by this Connection. The selected protocol must be supported by both the Local Node (/diameter/localnodes) and the Peer Node (/diameter/peernodes) assigned to this Connection. The transport protocols Tcp, Tls, Sctp, and Dtls may only be associated with Diameter Connections, while Udp may only be associated with RADIUS Connections. Required for all Connections. Note: The MP hosting this Connection should not have IPSEC enabled if this Connection is configured as Tls or Dtls, since enabling both IPSEC and TLS/TCP or DTLS/SCTP would have a significant, negative impact on Connection performance. This value is required for all Connections.",
"enum": [
"Sctp",
"Dtls",
"Tcp",
"Tls",
"Udp"
],
"type": "string"
},
"udpPort": {
"description": "For RADIUS Server Connections, this is the UDP port on which the DSR expects to receive incoming RADIUS requests for this Connection. For RADIUS Client Connections, this is the UDP port at the destination Peer Node (/diameter/peernodes), which receives the RADIUS request sent by the DSR. RADIUS Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"aaaProtocol",
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"localNodeName",
"name",
"peerIdentification",
"peerNodeName",
"localIp",
"transportProtocol"
],
"type": "object"
}
Example
{
"aaaProtocol": "Radius",
"altLocalIp": "10.24.5.42",
"altPeerIp": "52.36.25.63",
"capacityCfgSetName": "capCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"configurationLevel": "48",
"connCfgSetName": "connCfgSet1",
"connectionMode": "LocalMpResponder",
"isDynamic": false,
"localInitiatorPort": 6615,
"localIp": "10.24.2.8",
"localNodeName": "localNode1",
"msgConvCfgSetName": "msgConvCfgSet1",
"msgPriorityCfgSetName": "msgPriorityCfgSet1",
"msgPrioritySetting": "RequestMessage",
"name": "Connection1",
"peerIdentification": "Ip",
"peerIp": "52.36.41.9",
"peerNodeName": "peerNode1",
"remoteBusyTimeout": 30,
"remoteBusyUsage": true,
"statusServerCfgSetName": "statusServerCfgSet1",
"suppressConnAttempt": false,
"suppressConnUnavailableAlarm": true,
"testMode": false,
"transportFqdn": "transport.domain.com",
"transportProtocol": "Udp",
"udpPort": 42272
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/connections/connectionadminstate
put /diameter/connections/connectionadminstate
Updates the administrative state for all Connections specified in the request. The administrative update for multiple Connections is asynchronous, and creates a task when the request is received by the DSR. The task ID is returned to the client in the links section of the response. The status of the adminstrative update can be queried using the Task Monitoring API (/mon/tasks/{id}), which returns the status of the task specified by {id}. The status returned by /mon/tasks/{id} has an attribute named "details", and the value for "details" is a JSON-encoded string that contains: 1) the count of Connections that were successfully enabled/disabled; 2) the count of Connections that were not successfully enabled/disabled; and 3) and a final status message.
This API supports filtering, but only on the Connection name attribute, and only using the NOT_EQUAL, LIKE and IN filter operators. NOT_EQUAL takes a single Connection name for filter_value; LIKE takes a string that is used for pattern-matching, where the wildcard character is '*'. IN takes a comma-delimited list of Connection names.
Target Server: SOAM
Request
Query Parameters
- filter_name: (one of name)
The attribute name on which filtering occurs. For Connection bulk administrative enable/disable, only the Connection name field can be filtered.
Example:
filter_name=name
- filter_op: (one of NOT_EQUAL, LIKE, IN)
The filter operator. Only one operator can be specified for the Connection bulk administrative enable/disable filtering.
Example:
filter_op=IN
- filter_values: (string - repeat: true)
The Connection name(s) in the filter condition. If more than one Connection name is specified, the names should be comma-delimited.
Example:
filter_values='Conn1, Conn2, Conn3, Conn4'
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connectionadminstate.json",
"properties": {
"adminState": {
"description": "A Connection's administrative state can be either Enabled or Disabled. A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": ["adminState"],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
Response
HTTP status code 202
Successfully started the administrative enable/disable task.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
HTTP status code 400
The administrative enable/disable task could not be started successfully.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
/diameter/connections/status
get /diameter/connections/status
Returns the status of all Connections that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data (except primaryRemoteIpAddress , secondaryRemoteIpAddress and operationalReason - these attributes cannot be filtered). Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, or IN. LIKE is not supported for these data types. Boolean attributes can be filtered using only EQUAL. Connection Alarm Group can be filtered using EQUAL, NOT_EQUAL and LIKE. Alarm Ids can be filtered using LIKE.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types. Connection Alarm Group can be filtered using EQUAL, NOT_EQUAL and LIKE. Alarm Ids can be filtered using LIKE.
Example:
filter_name=cplValue
- filter_op: (one of EQUAL, NOT_EQUAL, IN, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=99
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/connectionstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connectionstatus.json",
"properties": {
"alarmIds": {
"description": "Alarm Id raised for the connection by the DAMP. This parameter will be present in the status data only if Alarm Group feature is enabled through Options (/diameter/options).",
"readOnly": true,
"type": "array"
},
"averageEgressMps": {
"description": "The current average number of messages per second that are sent by the DSR to the Peer Node (/diameter/peernodes) configured for this Connection.",
"type": "integer"
},
"averageIngressMps": {
"description": "The current average number of messages per second that are received by the DSR from the Peer Node (/diameter/peernodes) configured for this Connection.",
"type": "integer"
},
"commonApplicationIds": {
"description": "The set of Diameter Application Ids (/diameter/applicationids) that the DSR and Peer Node (/diameter/peernodes) both support on this Connection. This set of common Application Ids is determined during Connection establishment.",
"items": {
"type": "integer"
},
"type": "array"
},
"connAdminState": {
"description": "The administrative state of this Connection. A Connection in the Disabled state cannot become established; it must first be placed into the Enabled state before attempting to initiate or listen for the configured Peer Node (/diameter/peernodes) to initiate.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"connectionAlarmGroupName": {
"description": "A name given to a group of Connections (/diameter/connectionalarmgroups). Connection Alarm Group is used by Alarm Group feature if it is enabled. The feature can be enabled through Options (/diameter/options). This parameter will be present in the status data only if Alarm Group feature is enabled and Connection Alarm Group is created.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"cplValue": {
"description": "The Connection Priority Level (CPL) value for this Connection. A value of zero means the Connection has no impairments. A value of 99 means the Connection is operationally unavailable or administratively disabled. A value between 0 and 99 indicates the Connection is experiencing degraded operation.",
"type": "integer"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the DA-MP server that is currently reporting the status of this Connection. For all three Fixed-type Connections (Initiator, Responder, Initiator & Responder) and IPFE Initiator Connections, mpServerHostname indicates the DA-MP that is configured to host the Connection. For Floating Connections that are established (IPFE Responder, IPFE Initiator & Responder Connections), mpServerHostname is the DA-MP on which the Connection became established. For Floating Connections that are not established, mpServerHostname is the DA-MP Leader, since it is the DA-MP Leader that reports status for un-established Floating Connections.",
"type": "string"
},
"name": {
"description": "The configured name of the Connection.",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Connection.",
"type": "string"
},
"operationalStatus": {
"description": "The current operational state of the Connection. While this attribute can only have a value of Available, Degraded, or Unavailable, the operationalReason attribute typically contains additional information elaborating on the reported operationalStatus.",
"enum": [
"Available",
"Degraded",
"Unavailable"
],
"type": "string"
},
"pdusToDiagnose": {
"description": "The number of messages remaining to be received on this Connection that the DSR will treat as test messages for diagnostics purposes.",
"type": "integer"
},
"primaryRemoteIpAddress": {
"description": "The primary IP address of the Peer Node (/diameter/peernodes) configured for this Connection. Every established Connection has a primaryRemoteIpAddress value.",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:])+$",
"type": "string"
},
"remotePort": {
"description": "The port number the Peer Node (/diameter/peernodes) is using to receive messages on this Connection.",
"type": "integer"
},
"secondaryRemoteIpAddress": {
"description": "The secondary IP address of the Peer Node (/diameter/peernodes) configured for this Connection. Only SCTP multi-homed Connections have a secondaryRemoteIpAddress value.",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:])+$",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this Connection, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Connection was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][a-zA-Z]{3}[-][0-9]{2} [0-9]{2}[:][0-9]{2}[:][0-9]{2} .*$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"alarmIds": [
"22308",
"22307"
],
"averageEgressMps": 4590,
"averageIngressMps": 4595,
"commonApplicationIds": [
4,
16777224,
4294967295
],
"connAdminState": "Enabled",
"connectionAlarmGroupName": "connectionalarmgroup1",
"cplValue": 0,
"mpServerHostname": "MP1",
"name": "Conn1",
"operationalReason": "Normal",
"operationalStatus": "Available",
"pdusToDiagnose": 1,
"primaryRemoteIpAddress": "48.23.10.1",
"remotePort": 35081,
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/connections/{name}
get /diameter/connections/{name}
Returns the configuration details for the specified Connection. If the specified Connection does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Connections.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/connectionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connection.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Connection, which defines the Connection as either Diameter or Radius. This value is required for all Connections, and cannot be changed after the Connection is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"capacityCfgSetName": {
"description": "The Capacity Configuration Set (/diameter/capacityconfigurationsets) defines reserved and maximum ingress message processing rates and alarm thresholds for this connection. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/capabilitiesexchangeconfigurationsets) assigned to a Connection supplies capabilities exchange parameters used during connection establishment. Diameter Connections only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Connection supplies default values for a variety of transport connection parameters. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "Defines the connection initiation behavior of this Connection. LocalMpInitiator, LocalMpResponder, and FullySpecified apply only to Diameter Connections, while RadiusServer and RadiusClient only apply to RADIUS Connections. LocalMpInitiator means the Local Node (/diameter/localnodes) initiates a connection attempt to the Peer Node (/diameter/peernodes). LocalMpResponder means the Local Node does not initiate a connection attempt to the Peer Node, but only responds to a connection attempt initiated by the Peer Node. FullySpecified means the Local Node initiates a connection attempt, as well as responding to connection attempts initiated by the Peer Node. RadiusServer means the Local Node receives incoming RADIUS requests from a Peer Node configured as a RADIUS client. RadiusClient means the Local Node sends RADIUS requests to a Peer Node configured as a RADIUS server. This value is required for all Connections.",
"enum": [
"FullySpecified",
"LocalMpInitiator",
"LocalMpResponder",
"RadiusServer",
"RadiusClient"
],
"type": "string"
},
"ipfeInitiatorDampIp": {
"description": "If this Connection is an IPFE Connection and can be an initiator, the IPFE Initiator DA-MP is the one DA-MP that initiates the Connection to the Peer Node. This property must therefore be an IP address configured to the DA-MP that initiates the Connection, and the DA-MP must belong to the Target Set whose address(es) are configured as the local IP address(es) for this Connection. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"isDynamic": {
"description": "If true, means the Connection was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Connections only.",
"readOnly": true,
"type": "boolean"
},
"localInitiatorPort": {
"description": "The source port from which the DSR sends a connection initiation request to the Peer Node (/diameter/peernodes). Diameter Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"localIp": {
"description": "The IP address to be used as the primary Local Node (/diameter/localnodes) address for this Connection. This IP address must be one of the IP addresses configured for the Local Node assigned to this Connection. This value is required for all Connections.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNodeName": {
"description": "Name of the Local Node (/diameter/localnodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgAuthCfgSetName": {
"description": "Name of the Message Authenticator Configuration Set (/diameter/messageauthenticatorconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgConvCfgSetName": {
"description": "Name of the Message Conversion Configuration Set (/diameter/messageconversionconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Connection supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when this Connection's Message Priority Setting is UserConfigured. Diameter Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a Request and this Connection's Message Priority Setting is set to None, then the Peer Node's (/diameter/peernodes) Message Priority Setting determines how priority is assigned to a Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to UserConfigured, the Message Priority Configuration Set assigned to this Connection is used to determine the priority of request messages received from the Peer Node. Diameter Connections only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"msgThrottlingCfgSetName": {
"description": "Name of the Message Throttling Configuration Set (/diameter/messagethrottlingconfigurationsets) associated with this Connection.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the Connection, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerIdentification": {
"description": "Specifies how the Local Node (/diameter/localnodes) derives the Peer Node's (/diameter/peernodes) IP address(es) when initiating a Connection to the Peer Node, and whether the Local Node validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When None is specified, DSR does not validate the Peer Node's IP address(s) when responding to a Connection from the Peer Node. When IP is specified, DSR uses the Peer Node's IP address(es) configured for this Connection when initiating a Connection to the Peer Node, and validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When TransportFqdn is specified, DSR uses the DNS-resolved Transport FQDN address configured for this Connection when initiating a connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When PeerFqdn is specified, DSR uses the DNS-resolved FQDN address configured for the Peer Node associated with this Connection when initiating a Connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. This value is required for all Connections.",
"enum": [
"Ip",
"TransportFqdn",
"PeerFqdn",
"None"
],
"type": "string"
},
"peerIp": {
"description": "The IP address to be used as the primary Peer Node (/diameter/peernodes) address for this Connection. Required for RADIUS Connections. For Diameter Connections, required whenever peerIdentification is not IP. priPeerIp must be one of the IP addresses configured for the Peer Node assigned to this Connection.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteBusyTimeout": {
"description": "Defines the time period (in seconds) that a Connection is considered BUSY from the last time a DIAMETER_TOO_BUSY response was received. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"remoteBusyUsage": {
"description": "Defines which Request messages can be forwarded on this Connection after receiving a DIAMETER_TOO_BUSY response from the Connection's Peer Node (/diameter/peernodes). When set to false, the Connection is not considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. All Request messages continue to be forwarded to (or rerouted to) this Connection. When set to true, the Connection is considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. No Request messages can be forwarded to (or rerouted to) this Connection until the Remote Busy Abatement Timeout expires. Diameter Connections only.",
"type": "boolean"
},
"altLocalIp": {
"description": "The IP address to be used as the alternate Local Node (/diameter/localnodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary local IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"altPeerIp": {
"description": "The IP address to be used as the alternate Peer Node (/diameter/peernodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary peer IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"sharedSecretCfgSetName": {
"description": "Name of the Shared Secret Configuration Set (/diameter/sharedsecretconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerCfgSetName": {
"description": "Name of the Ingress Status-Server Configuration Set (/diameter/statusserverconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"suppressConnAttempt": {
"description": "If true, connection attempts to the standby Peer Node (/diameter/peernodes) are suppressed once the Peer Node's Operational Status is Available. Diameter Connections only. ",
"type": "boolean"
},
"suppressConnUnavailableAlarm": {
"description": "If true, a connection unavailable alarm is not raised for this Connection whenever the Connection becomes Unavailable. Diameter Connections only. ",
"type": "boolean"
},
"testMode": {
"description": "If true, indicates the Connection is in test mode. Diameter Connections only.",
"type": "boolean"
},
"transportCongTimeout": {
"description": "Defines the time period (in seconds) spent by the Connection in abating each congestion level during abatement. Typical value is 5 seconds. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"transportFqdn": {
"description": "Fully Qualified Domain Name for this Connection. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long. Diameter Connections only.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"transportProtocol": {
"description": "The transport protocol used by this Connection. The selected protocol must be supported by both the Local Node (/diameter/localnodes) and the Peer Node (/diameter/peernodes) assigned to this Connection. The transport protocols Tcp, Tls, Sctp, and Dtls may only be associated with Diameter Connections, while Udp may only be associated with RADIUS Connections. Required for all Connections. Note: The MP hosting this Connection should not have IPSEC enabled if this Connection is configured as Tls or Dtls, since enabling both IPSEC and TLS/TCP or DTLS/SCTP would have a significant, negative impact on Connection performance. This value is required for all Connections.",
"enum": [
"Sctp",
"Dtls",
"Tcp",
"Tls",
"Udp"
],
"type": "string"
},
"udpPort": {
"description": "For RADIUS Server Connections, this is the UDP port on which the DSR expects to receive incoming RADIUS requests for this Connection. For RADIUS Client Connections, this is the UDP port at the destination Peer Node (/diameter/peernodes), which receives the RADIUS request sent by the DSR. RADIUS Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"aaaProtocol",
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"localNodeName",
"name",
"peerIdentification",
"peerNodeName",
"localIp",
"transportProtocol"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"aaaProtocol": "Radius",
"altLocalIp": "10.24.5.42",
"altPeerIp": "52.36.25.63",
"capacityCfgSetName": "capCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"configurationLevel": "48",
"connCfgSetName": "connCfgSet1",
"connectionMode": "LocalMpResponder",
"isDynamic": false,
"localInitiatorPort": 6615,
"localIp": "10.24.2.8",
"localNodeName": "localNode1",
"msgConvCfgSetName": "msgConvCfgSet1",
"msgPriorityCfgSetName": "msgPriorityCfgSet1",
"msgPrioritySetting": "RequestMessage",
"name": "Connection1",
"peerIdentification": "Ip",
"peerIp": "52.36.41.9",
"peerNodeName": "peerNode1",
"remoteBusyTimeout": 30,
"remoteBusyUsage": true,
"statusServerCfgSetName": "statusServerCfgSet1",
"suppressConnAttempt": false,
"suppressConnUnavailableAlarm": true,
"testMode": false,
"transportFqdn": "transport.domain.com",
"transportProtocol": "Udp",
"udpPort": 42272
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/connections/{name}
Updates the configuration for the specified Connection. If the provided Connection data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Connections.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connection.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Connection, which defines the Connection as either Diameter or Radius. This value is required for all Connections, and cannot be changed after the Connection is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"capacityCfgSetName": {
"description": "The Capacity Configuration Set (/diameter/capacityconfigurationsets) defines reserved and maximum ingress message processing rates and alarm thresholds for this connection. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/capabilitiesexchangeconfigurationsets) assigned to a Connection supplies capabilities exchange parameters used during connection establishment. Diameter Connections only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Connection supplies default values for a variety of transport connection parameters. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "Defines the connection initiation behavior of this Connection. LocalMpInitiator, LocalMpResponder, and FullySpecified apply only to Diameter Connections, while RadiusServer and RadiusClient only apply to RADIUS Connections. LocalMpInitiator means the Local Node (/diameter/localnodes) initiates a connection attempt to the Peer Node (/diameter/peernodes). LocalMpResponder means the Local Node does not initiate a connection attempt to the Peer Node, but only responds to a connection attempt initiated by the Peer Node. FullySpecified means the Local Node initiates a connection attempt, as well as responding to connection attempts initiated by the Peer Node. RadiusServer means the Local Node receives incoming RADIUS requests from a Peer Node configured as a RADIUS client. RadiusClient means the Local Node sends RADIUS requests to a Peer Node configured as a RADIUS server. This value is required for all Connections.",
"enum": [
"FullySpecified",
"LocalMpInitiator",
"LocalMpResponder",
"RadiusServer",
"RadiusClient"
],
"type": "string"
},
"ipfeInitiatorDampIp": {
"description": "If this Connection is an IPFE Connection and can be an initiator, the IPFE Initiator DA-MP is the one DA-MP that initiates the Connection to the Peer Node. This property must therefore be an IP address configured to the DA-MP that initiates the Connection, and the DA-MP must belong to the Target Set whose address(es) are configured as the local IP address(es) for this Connection. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"isDynamic": {
"description": "If true, means the Connection was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Connections only.",
"readOnly": true,
"type": "boolean"
},
"localInitiatorPort": {
"description": "The source port from which the DSR sends a connection initiation request to the Peer Node (/diameter/peernodes). Diameter Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"localIp": {
"description": "The IP address to be used as the primary Local Node (/diameter/localnodes) address for this Connection. This IP address must be one of the IP addresses configured for the Local Node assigned to this Connection. This value is required for all Connections.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNodeName": {
"description": "Name of the Local Node (/diameter/localnodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgAuthCfgSetName": {
"description": "Name of the Message Authenticator Configuration Set (/diameter/messageauthenticatorconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgConvCfgSetName": {
"description": "Name of the Message Conversion Configuration Set (/diameter/messageconversionconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Connection supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when this Connection's Message Priority Setting is UserConfigured. Diameter Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a Request and this Connection's Message Priority Setting is set to None, then the Peer Node's (/diameter/peernodes) Message Priority Setting determines how priority is assigned to a Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to UserConfigured, the Message Priority Configuration Set assigned to this Connection is used to determine the priority of request messages received from the Peer Node. Diameter Connections only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"msgThrottlingCfgSetName": {
"description": "Name of the Message Throttling Configuration Set (/diameter/messagethrottlingconfigurationsets) associated with this Connection.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the Connection, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Connections.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerIdentification": {
"description": "Specifies how the Local Node (/diameter/localnodes) derives the Peer Node's (/diameter/peernodes) IP address(es) when initiating a Connection to the Peer Node, and whether the Local Node validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When None is specified, DSR does not validate the Peer Node's IP address(s) when responding to a Connection from the Peer Node. When IP is specified, DSR uses the Peer Node's IP address(es) configured for this Connection when initiating a Connection to the Peer Node, and validates the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When TransportFqdn is specified, DSR uses the DNS-resolved Transport FQDN address configured for this Connection when initiating a connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. When PeerFqdn is specified, DSR uses the DNS-resolved FQDN address configured for the Peer Node associated with this Connection when initiating a Connection to the Peer Node, and does not validate the Peer Node's IP address(es) when responding to a Connection from the Peer Node. This value is required for all Connections.",
"enum": [
"Ip",
"TransportFqdn",
"PeerFqdn",
"None"
],
"type": "string"
},
"peerIp": {
"description": "The IP address to be used as the primary Peer Node (/diameter/peernodes) address for this Connection. Required for RADIUS Connections. For Diameter Connections, required whenever peerIdentification is not IP. priPeerIp must be one of the IP addresses configured for the Peer Node assigned to this Connection.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this Connection. This value is required for all Connections.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteBusyTimeout": {
"description": "Defines the time period (in seconds) that a Connection is considered BUSY from the last time a DIAMETER_TOO_BUSY response was received. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"remoteBusyUsage": {
"description": "Defines which Request messages can be forwarded on this Connection after receiving a DIAMETER_TOO_BUSY response from the Connection's Peer Node (/diameter/peernodes). When set to false, the Connection is not considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. All Request messages continue to be forwarded to (or rerouted to) this Connection. When set to true, the Connection is considered to be BUSY after receiving a DIAMETER_TOO_BUSY response. No Request messages can be forwarded to (or rerouted to) this Connection until the Remote Busy Abatement Timeout expires. Diameter Connections only.",
"type": "boolean"
},
"altLocalIp": {
"description": "The IP address to be used as the alternate Local Node (/diameter/localnodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary local IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"altPeerIp": {
"description": "The IP address to be used as the alternate Peer Node (/diameter/peernodes) address for this Connection. This address is only used for SCTP multi-homing, and must be different from the address chosen for the primary peer IP address. Diameter Connections only.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"sharedSecretCfgSetName": {
"description": "Name of the Shared Secret Configuration Set (/diameter/sharedsecretconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerCfgSetName": {
"description": "Name of the Ingress Status-Server Configuration Set (/diameter/statusserverconfigurationsets) associated with this Connection. RADIUS Connections only.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"suppressConnAttempt": {
"description": "If true, connection attempts to the standby Peer Node (/diameter/peernodes) are suppressed once the Peer Node's Operational Status is Available. Diameter Connections only. ",
"type": "boolean"
},
"suppressConnUnavailableAlarm": {
"description": "If true, a connection unavailable alarm is not raised for this Connection whenever the Connection becomes Unavailable. Diameter Connections only. ",
"type": "boolean"
},
"testMode": {
"description": "If true, indicates the Connection is in test mode. Diameter Connections only.",
"type": "boolean"
},
"transportCongTimeout": {
"description": "Defines the time period (in seconds) spent by the Connection in abating each congestion level during abatement. Typical value is 5 seconds. Diameter Connections only.",
"maximum": 60,
"minimum": 3,
"type": "integer"
},
"transportFqdn": {
"description": "Fully Qualified Domain Name for this Connection. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long. Diameter Connections only.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"transportProtocol": {
"description": "The transport protocol used by this Connection. The selected protocol must be supported by both the Local Node (/diameter/localnodes) and the Peer Node (/diameter/peernodes) assigned to this Connection. The transport protocols Tcp, Tls, Sctp, and Dtls may only be associated with Diameter Connections, while Udp may only be associated with RADIUS Connections. Required for all Connections. Note: The MP hosting this Connection should not have IPSEC enabled if this Connection is configured as Tls or Dtls, since enabling both IPSEC and TLS/TCP or DTLS/SCTP would have a significant, negative impact on Connection performance. This value is required for all Connections.",
"enum": [
"Sctp",
"Dtls",
"Tcp",
"Tls",
"Udp"
],
"type": "string"
},
"udpPort": {
"description": "For RADIUS Server Connections, this is the UDP port on which the DSR expects to receive incoming RADIUS requests for this Connection. For RADIUS Client Connections, this is the UDP port at the destination Peer Node (/diameter/peernodes), which receives the RADIUS request sent by the DSR. RADIUS Connections only.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"aaaProtocol",
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"localNodeName",
"name",
"peerIdentification",
"peerNodeName",
"localIp",
"transportProtocol"
],
"type": "object"
}
Example
{
"aaaProtocol": "Radius",
"altLocalIp": "10.24.5.42",
"altPeerIp": "52.36.25.63",
"capacityCfgSetName": "capCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"configurationLevel": "48",
"connCfgSetName": "connCfgSet1",
"connectionMode": "LocalMpResponder",
"isDynamic": false,
"localInitiatorPort": 6615,
"localIp": "10.24.2.8",
"localNodeName": "localNode1",
"msgConvCfgSetName": "msgConvCfgSet1",
"msgPriorityCfgSetName": "msgPriorityCfgSet1",
"msgPrioritySetting": "RequestMessage",
"name": "Connection1",
"peerIdentification": "Ip",
"peerIp": "52.36.41.9",
"peerNodeName": "peerNode1",
"remoteBusyTimeout": 30,
"remoteBusyUsage": true,
"statusServerCfgSetName": "statusServerCfgSet1",
"suppressConnAttempt": false,
"suppressConnUnavailableAlarm": true,
"testMode": false,
"transportFqdn": "transport.domain.com",
"transportProtocol": "Udp",
"udpPort": 42272
}
delete /diameter/connections/{name}
Deletes the specified Connection from the SOAM configuration. A Connection is only deleted if all delete validation checks pass. In general, if the Connection is part of the configuration of some other Managed Object, the Connection cannot be deleted. For example, if the Connection is named in a Connection Route Group (/diameter/routegroups), the Connection must first be removed from the Route Group. Then the Connection can be deleted from the configuration. An attempt to delete a Connection that cannot be deleted results in an error message returned within the HTTP response.
Any Connection that is administratively enabled cannot be deleted. The Connection must first be administratively disabled before deletion is allowed.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/diameter/connections/{name}/connectionadminstate
get /diameter/connections/{name}/connectionadminstate
Retrieves the administrative state, which can be either Enabled or Disabled, for the specified Connection.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/connectionadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connectionadminstate.json",
"properties": {
"adminState": {
"description": "A Connection's administrative state can be either Enabled or Disabled. A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": ["adminState"],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/connections/{name}/connectionadminstate
Updates the administrative state for the specified Diameter or RADIUS Connection to either Enable or Disabled.
A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connectionadminstate.json",
"properties": {
"adminState": {
"description": "A Connection's administrative state can be either Enabled or Disabled. A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": ["adminState"],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
/diameter/connections/{name}/status
get /diameter/connections/{name}/status
Retrieves the operational status for the specified Connection.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/connectionstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/connection/connectionstatus.json",
"properties": {
"alarmIds": {
"description": "Alarm Id raised for the connection by the DAMP. This parameter will be present in the status data only if Alarm Group feature is enabled through Options (/diameter/options).",
"readOnly": true,
"type": "array"
},
"averageEgressMps": {
"description": "The current average number of messages per second that are sent by the DSR to the Peer Node (/diameter/peernodes) configured for this Connection.",
"type": "integer"
},
"averageIngressMps": {
"description": "The current average number of messages per second that are received by the DSR from the Peer Node (/diameter/peernodes) configured for this Connection.",
"type": "integer"
},
"commonApplicationIds": {
"description": "The set of Diameter Application Ids (/diameter/applicationids) that the DSR and Peer Node (/diameter/peernodes) both support on this Connection. This set of common Application Ids is determined during Connection establishment.",
"items": {
"type": "integer"
},
"type": "array"
},
"connAdminState": {
"description": "The administrative state of this Connection. A Connection in the Disabled state cannot become established; it must first be placed into the Enabled state before attempting to initiate or listen for the configured Peer Node (/diameter/peernodes) to initiate.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"connectionAlarmGroupName": {
"description": "A name given to a group of Connections (/diameter/connectionalarmgroups). Connection Alarm Group is used by Alarm Group feature if it is enabled. The feature can be enabled through Options (/diameter/options). This parameter will be present in the status data only if Alarm Group feature is enabled and Connection Alarm Group is created.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"cplValue": {
"description": "The Connection Priority Level (CPL) value for this Connection. A value of zero means the Connection has no impairments. A value of 99 means the Connection is operationally unavailable or administratively disabled. A value between 0 and 99 indicates the Connection is experiencing degraded operation.",
"type": "integer"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the DA-MP server that is currently reporting the status of this Connection. For all three Fixed-type Connections (Initiator, Responder, Initiator & Responder) and IPFE Initiator Connections, mpServerHostname indicates the DA-MP that is configured to host the Connection. For Floating Connections that are established (IPFE Responder, IPFE Initiator & Responder Connections), mpServerHostname is the DA-MP on which the Connection became established. For Floating Connections that are not established, mpServerHostname is the DA-MP Leader, since it is the DA-MP Leader that reports status for un-established Floating Connections.",
"type": "string"
},
"name": {
"description": "The configured name of the Connection.",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Connection.",
"type": "string"
},
"operationalStatus": {
"description": "The current operational state of the Connection. While this attribute can only have a value of Available, Degraded, or Unavailable, the operationalReason attribute typically contains additional information elaborating on the reported operationalStatus.",
"enum": [
"Available",
"Degraded",
"Unavailable"
],
"type": "string"
},
"pdusToDiagnose": {
"description": "The number of messages remaining to be received on this Connection that the DSR will treat as test messages for diagnostics purposes.",
"type": "integer"
},
"primaryRemoteIpAddress": {
"description": "The primary IP address of the Peer Node (/diameter/peernodes) configured for this Connection. Every established Connection has a primaryRemoteIpAddress value.",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:])+$",
"type": "string"
},
"remotePort": {
"description": "The port number the Peer Node (/diameter/peernodes) is using to receive messages on this Connection.",
"type": "integer"
},
"secondaryRemoteIpAddress": {
"description": "The secondary IP address of the Peer Node (/diameter/peernodes) configured for this Connection. Only SCTP multi-homed Connections have a secondaryRemoteIpAddress value.",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:])+$",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this Connection, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Connection was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][a-zA-Z]{3}[-][0-9]{2} [0-9]{2}[:][0-9]{2}[:][0-9]{2} .*$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"alarmIds": [
"22308",
"22307"
],
"averageEgressMps": 4590,
"averageIngressMps": 4595,
"commonApplicationIds": [
4,
16777224,
4294967295
],
"connAdminState": "Enabled",
"connectionAlarmGroupName": "connectionalarmgroup1",
"cplValue": 0,
"mpServerHostname": "MP1",
"name": "Conn1",
"operationalReason": "Normal",
"operationalStatus": "Available",
"pdusToDiagnose": 1,
"primaryRemoteIpAddress": "48.23.10.1",
"remotePort": 35081,
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: DA-MP Peer Server Hostname Status
The DA-MP Server Hostname Status Table shows the status of each DA-MP peer as reported by the DA-MP whose hostname appears in the table.
/diameter/dampserverhostnames/status
get /diameter/dampserverhostnames/status
Returns the status of all DA-MP Hostnames that meet the criteria specified in the request.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/dampserverhostnamestatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dampserverhostnamestatus/dampserverhostnamestatus.json",
"properties": {
"cplReason": {
"description": "Reason for CPL setting.",
"enum": [
"Available",
"MP Congestion",
"Inter-MP Connection Unavailable",
"DSR Process Not Running",
"Unknown"
],
"default": "Unknown",
"type": "string"
},
"cplValue": {
"description": "Connection Priority Level (0,1, 2, 3, 98, 99) of the configured peer DA-MP. If CPL Value is 0 then it meant for status as Available. CPL Values 1, 2, 3, 98 are for Degraded status and CPL Value 99 is eligible for Unavailable status.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"serverHostname": {
"description": "The hostname of the reporting DA-MP server.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
},
"status": {
"description": "Peer DA-MP status.",
"enum": [
"Available",
"Degraded",
"Unavailable",
"Unknown"
],
"default": "Unknown",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this DAMP Peer Server Hostname are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this DAMP Peer Server Hostname. If the OAM has current status for this DAMP Peer Server Hostname, statusKnown is set to true.",
"type": "boolean"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"cplReason": "Available",
"cplValue": 0,
"serverHostname": "MP1",
"status": "Available",
"statusKnown": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Diameter: DNS Options
The DNS Options resource includes information the DSR needs if it must resolve one or more Peer Node (/diameter/peernodes) FQDNs to IP addresses. Peer Node configuration does not mandate that an IP address be specified. If no IP address is specified, then any attempt by the DSR to establish an Initiator or Initiator+Responder Connection (/diameter/connections) to that Peer Node requires a DNS lookup to resolve the FQDN to the correct IP address. The DNS server(s) the DSR uses for such lookups are located at the IP address(es) given in the DNS Options.
If: 1) every Peer Node configured at the DSR includes one or more IP addresses, and/or 2) only Responder-only Connections are configured at the DSR, then the DNS Options are not required, because the DSR does not have to issue DNS queries to retrieve Peer Node IP addresses.
/diameter/dnsoptions
get /diameter/dnsoptions
Returns the set of current values for the DNS Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/dnsoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dnsoption/dnsoption.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"primaryIp": {
"description": "The IP address of the primary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"queryDuration": {
"description": "If no response is received from the primary DNS server, the DSR waits queryDuration seconds before sending the same DNS query to the secondary DNS server. If no response is received from the secondary DNS server, the DNS query fails - DSR makes no attempt to re-try either DNS server.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"secondaryIp": {
"description": "The IP address of the secondary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs. The secondary DNS server is only queried if the query to the primary DNS server times out.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
}
},
"required": ["queryDuration"],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "51",
"primaryIp": "1.2.3.4",
"queryDuration": 3,
"secondaryIp": "2.3.4.5"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /diameter/dnsoptions
Updates the DNS Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dnsoption/dnsoption.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"primaryIp": {
"description": "The IP address of the primary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"queryDuration": {
"description": "If no response is received from the primary DNS server, the DSR waits queryDuration seconds before sending the same DNS query to the secondary DNS server. If no response is received from the secondary DNS server, the DNS query fails - DSR makes no attempt to re-try either DNS server.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"secondaryIp": {
"description": "The IP address of the secondary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs. The secondary DNS server is only queried if the query to the primary DNS server times out.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
}
},
"required": ["queryDuration"],
"type": "object"
}
Example
{
"configurationLevel": "51",
"primaryIp": "1.2.3.4",
"queryDuration": 3,
"secondaryIp": "2.3.4.5"
}
Diameter:Peer Discovery: Discovery Attributes
Additional discovery attributes are all statically configured by a user, to establish the input parameters governing the discovery of a particular Diameter Realm.The information contained in the Discovery Attributes instance is used to execute the discovery.
/diameter/dpdattributesets
get /diameter/dpdattributesets
Returns all Discovery Attributes configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Discovery Attributes meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/dpdattributesetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsrocgbu.oracle.com/schemas/diameter/dpdattributesets/dpdattributesets",
"properties": {
"applications": {
"description": "Applications offered by Peer Discovery",
"items": {
"properties": {
"addSuppVendorID": {
"description": "Additional Supported Vendor Ids - Vendor Ids, in addition to the one specified in the CEX Parameter, which can be paired with the Application Id. It is the value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"cexParameter": {
"description": "The natural identifier for the CEX Parameter instance (which has no name)is a combination of appId(appId-appName)-appIdType-vendorId.",
"readOnly": true,
"type": "string"
},
"dtlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"sctpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tcpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"maxConn": {
"description": "The maximum number of peers within the Realm that are created spanning discovered Peers that support the associated Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
},
"maxPeers": {
"description": "max number of peers within the Realm that are created for the selection Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"capacityCfgSetName": {
"description": "Capacity Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connCfgSetName": {
"description": "Connection Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionMode": {
"description": "Initiator means that all Connections to discovered Peers will be Initiator Only, and so the DSR will attempt to initiate connection to these Peers.Initiator & Responder means that all Connections to discovered Peers will be of type Initiator & Responder, and so the DSR will both attempt to initiate connection to the discovered Peers as well as listen for connection attempts from these Peers.",
"enum": [
"Initiator",
"InitiatorResponder"
],
"type": "string",
"default": "InitiatorResponder"
},
"dnsSet": {
"description": "DNS server set used for Realm discovery.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"followProtoPref": {
"description": "If selected, indicates that the local protocol preferences specified for each application ID will take precedence over the protocol preference(s) discovered for each Peer in this Realm.",
"type": "boolean"
},
"ipfeInitiatorDAMPIp": {
"description": "The DA-MP that will initiate the dynamic Connections. Mandatory if the Local IP Address is a Target Set Address, otherwise not applicable.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localIp": {
"description": "The IP Address to be used as the Local Node address for all dynamic Connections made to Peers in this Realm. SCTP multi-homed Connections to discovered Peers are not supported.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNode": {
"description": "Local Node used to connect to all Peers discovered within the Realm.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm in which Diameter Peers are to be discovered.",
"maxlength": 255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"realmPrefix": {
"description": "The Realm prefix string is used as the first part of the name of all configuration objects that are dynamically created by the DSR as part of discovering the Realm.",
"maxlength": 12,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"dnsSet",
"localIp",
"localNode",
"realm",
"realmPrefix"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"applications": [
{
"addSuppVendorID": 756,
"cexParameter": "16777216-Authentication-756",
"dtlsPreference": 0,
"maxConn": 2,
"maxPeers": 2,
"sctpPreference": 0,
"tcpPreference": 0,
"tlsPreference": 0
}
],
"capacityCfgSetName": "Default",
"configurationLevel": "475",
"connCfgSetName": "Default",
"connectionMode": "Initiator",
"dnsSet": "testme1",
"followProtoPref": false,
"localIp": "20.20.20.2",
"localNode": "SCEF",
"realm": "test1.com",
"realmPrefix": "d1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/dpdattributesets
Adds a new Discovery Attribute to the DSR configuration. The new Local Node must have a name that is unique to the SOAM's configuration. A single Local Node can be configured to support Diameter Connections (/diameter/connections), RADIUS Connections (/diameter/connections), or both.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsrocgbu.oracle.com/schemas/diameter/dpdattributesets/dpdattributesets",
"properties": {
"applications": {
"description": "Applications offered by Peer Discovery",
"items": {
"properties": {
"addSuppVendorID": {
"description": "Additional Supported Vendor Ids - Vendor Ids, in addition to the one specified in the CEX Parameter, which can be paired with the Application Id. It is the value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"cexParameter": {
"description": "The natural identifier for the CEX Parameter instance (which has no name)is a combination of appId(appId-appName)-appIdType-vendorId.",
"readOnly": true,
"type": "string"
},
"dtlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"sctpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tcpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"maxConn": {
"description": "The maximum number of peers within the Realm that are created spanning discovered Peers that support the associated Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
},
"maxPeers": {
"description": "max number of peers within the Realm that are created for the selection Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"capacityCfgSetName": {
"description": "Capacity Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connCfgSetName": {
"description": "Connection Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionMode": {
"description": "Initiator means that all Connections to discovered Peers will be Initiator Only, and so the DSR will attempt to initiate connection to these Peers.Initiator & Responder means that all Connections to discovered Peers will be of type Initiator & Responder, and so the DSR will both attempt to initiate connection to the discovered Peers as well as listen for connection attempts from these Peers.",
"enum": [
"Initiator",
"InitiatorResponder"
],
"type": "string",
"default": "InitiatorResponder"
},
"dnsSet": {
"description": "DNS server set used for Realm discovery.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"followProtoPref": {
"description": "If selected, indicates that the local protocol preferences specified for each application ID will take precedence over the protocol preference(s) discovered for each Peer in this Realm.",
"type": "boolean"
},
"ipfeInitiatorDAMPIp": {
"description": "The DA-MP that will initiate the dynamic Connections. Mandatory if the Local IP Address is a Target Set Address, otherwise not applicable.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localIp": {
"description": "The IP Address to be used as the Local Node address for all dynamic Connections made to Peers in this Realm. SCTP multi-homed Connections to discovered Peers are not supported.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNode": {
"description": "Local Node used to connect to all Peers discovered within the Realm.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm in which Diameter Peers are to be discovered.",
"maxlength": 255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"realmPrefix": {
"description": "The Realm prefix string is used as the first part of the name of all configuration objects that are dynamically created by the DSR as part of discovering the Realm.",
"maxlength": 12,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"dnsSet",
"localIp",
"localNode",
"realm",
"realmPrefix"
],
"type": "object"
}
Example
{
"applications": [
{
"addSuppVendorID": 756,
"cexParameter": "16777216-Authentication-756",
"dtlsPreference": 0,
"maxConn": 2,
"maxPeers": 2,
"sctpPreference": 0,
"tcpPreference": 0,
"tlsPreference": 0
}
],
"capacityCfgSetName": "Default",
"configurationLevel": "475",
"connCfgSetName": "Default",
"connectionMode": "Initiator",
"dnsSet": "testme1",
"followProtoPref": false,
"localIp": "20.20.20.2",
"localNode": "SCEF",
"realm": "test1.com",
"realmPrefix": "d1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/dpdattributesets/{realm}
get /diameter/dpdattributesets/{realm}
Returns the configuration details for the specified Discovery Attribute. If the specified Realm does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- realm: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/dpdattributesetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsrocgbu.oracle.com/schemas/diameter/dpdattributesets/dpdattributesets",
"properties": {
"applications": {
"description": "Applications offered by Peer Discovery",
"items": {
"properties": {
"addSuppVendorID": {
"description": "Additional Supported Vendor Ids - Vendor Ids, in addition to the one specified in the CEX Parameter, which can be paired with the Application Id. It is the value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"cexParameter": {
"description": "The natural identifier for the CEX Parameter instance (which has no name)is a combination of appId(appId-appName)-appIdType-vendorId.",
"readOnly": true,
"type": "string"
},
"dtlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"sctpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tcpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"maxConn": {
"description": "The maximum number of peers within the Realm that are created spanning discovered Peers that support the associated Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
},
"maxPeers": {
"description": "max number of peers within the Realm that are created for the selection Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"capacityCfgSetName": {
"description": "Capacity Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connCfgSetName": {
"description": "Connection Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionMode": {
"description": "Initiator means that all Connections to discovered Peers will be Initiator Only, and so the DSR will attempt to initiate connection to these Peers.Initiator & Responder means that all Connections to discovered Peers will be of type Initiator & Responder, and so the DSR will both attempt to initiate connection to the discovered Peers as well as listen for connection attempts from these Peers.",
"enum": [
"Initiator",
"InitiatorResponder"
],
"type": "string",
"default": "InitiatorResponder"
},
"dnsSet": {
"description": "DNS server set used for Realm discovery.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"followProtoPref": {
"description": "If selected, indicates that the local protocol preferences specified for each application ID will take precedence over the protocol preference(s) discovered for each Peer in this Realm.",
"type": "boolean"
},
"ipfeInitiatorDAMPIp": {
"description": "The DA-MP that will initiate the dynamic Connections. Mandatory if the Local IP Address is a Target Set Address, otherwise not applicable.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localIp": {
"description": "The IP Address to be used as the Local Node address for all dynamic Connections made to Peers in this Realm. SCTP multi-homed Connections to discovered Peers are not supported.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNode": {
"description": "Local Node used to connect to all Peers discovered within the Realm.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm in which Diameter Peers are to be discovered.",
"maxlength": 255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"realmPrefix": {
"description": "The Realm prefix string is used as the first part of the name of all configuration objects that are dynamically created by the DSR as part of discovering the Realm.",
"maxlength": 12,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"dnsSet",
"localIp",
"localNode",
"realm",
"realmPrefix"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"applications": [
{
"addSuppVendorID": 756,
"cexParameter": "16777216-Authentication-756",
"dtlsPreference": 0,
"maxConn": 2,
"maxPeers": 2,
"sctpPreference": 0,
"tcpPreference": 0,
"tlsPreference": 0
}
],
"capacityCfgSetName": "Default",
"configurationLevel": "475",
"connCfgSetName": "Default",
"connectionMode": "Initiator",
"dnsSet": "testme1",
"followProtoPref": false,
"localIp": "20.20.20.2",
"localNode": "SCEF",
"realm": "test1.com",
"realmPrefix": "d1"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/dpdattributesets/{realm}
Updates the configuration for the specified Discovery Attribute. If the provided Discovery Attribute data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- realm: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsrocgbu.oracle.com/schemas/diameter/dpdattributesets/dpdattributesets",
"properties": {
"applications": {
"description": "Applications offered by Peer Discovery",
"items": {
"properties": {
"addSuppVendorID": {
"description": "Additional Supported Vendor Ids - Vendor Ids, in addition to the one specified in the CEX Parameter, which can be paired with the Application Id. It is the value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"cexParameter": {
"description": "The natural identifier for the CEX Parameter instance (which has no name)is a combination of appId(appId-appName)-appIdType-vendorId.",
"readOnly": true,
"type": "string"
},
"dtlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"sctpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tcpPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"tlsPreference": {
"description": "If zero, the associated protocol is not used for connections to a discovered Peer. Values 1 - 4 indicate the hierarchical local protocol preferences (1 is most preferred, 4 is least preferred).You can assign the same value to more than one protocol.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"maxConn": {
"description": "The maximum number of peers within the Realm that are created spanning discovered Peers that support the associated Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
},
"maxPeers": {
"description": "max number of peers within the Realm that are created for the selection Application ID.",
"maximum": 3,
"minimum": 1,
"type": "integer",
"default": 2
}
},
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"capacityCfgSetName": {
"description": "Capacity Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connCfgSetName": {
"description": "Connection Configuration Set to be used by all dynamic Connections made to Peers in this Realm.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionMode": {
"description": "Initiator means that all Connections to discovered Peers will be Initiator Only, and so the DSR will attempt to initiate connection to these Peers.Initiator & Responder means that all Connections to discovered Peers will be of type Initiator & Responder, and so the DSR will both attempt to initiate connection to the discovered Peers as well as listen for connection attempts from these Peers.",
"enum": [
"Initiator",
"InitiatorResponder"
],
"type": "string",
"default": "InitiatorResponder"
},
"dnsSet": {
"description": "DNS server set used for Realm discovery.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"followProtoPref": {
"description": "If selected, indicates that the local protocol preferences specified for each application ID will take precedence over the protocol preference(s) discovered for each Peer in this Realm.",
"type": "boolean"
},
"ipfeInitiatorDAMPIp": {
"description": "The DA-MP that will initiate the dynamic Connections. Mandatory if the Local IP Address is a Target Set Address, otherwise not applicable.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localIp": {
"description": "The IP Address to be used as the Local Node address for all dynamic Connections made to Peers in this Realm. SCTP multi-homed Connections to discovered Peers are not supported.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localNode": {
"description": "Local Node used to connect to all Peers discovered within the Realm.",
"maxlength": 255,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm in which Diameter Peers are to be discovered.",
"maxlength": 255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"realmPrefix": {
"description": "The Realm prefix string is used as the first part of the name of all configuration objects that are dynamically created by the DSR as part of discovering the Realm.",
"maxlength": 12,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"capacityCfgSetName",
"connCfgSetName",
"connectionMode",
"dnsSet",
"localIp",
"localNode",
"realm",
"realmPrefix"
],
"type": "object"
}
Example
{
"applications": [
{
"addSuppVendorID": 756,
"cexParameter": "16777216-Authentication-756",
"dtlsPreference": 0,
"maxConn": 2,
"maxPeers": 2,
"sctpPreference": 0,
"tcpPreference": 0,
"tlsPreference": 0
}
],
"capacityCfgSetName": "Default",
"configurationLevel": "475",
"connCfgSetName": "Default",
"connectionMode": "Initiator",
"dnsSet": "testme1",
"followProtoPref": false,
"localIp": "20.20.20.2",
"localNode": "SCEF",
"realm": "test1.com",
"realmPrefix": "d1"
}
delete /diameter/dpdattributesets/{realm}
Deletes the specified Discovery Attribute from the SOAM configuration. A Discovery Attribute will only be deleted if all delete validation checks pass. If the Discovery Attribute is part of the configuration of some other Managed Object, the Discovery Attribute cannot be deleted. An attempt to delete a Discovery Attribute that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- realm: required (string)
Diameter:Peer Discovery Realms
A realm is an internet domain whose Fully-Qualified Domain Names (FQDNs) typically all share a domain designation.In the diameter signaling space, an operator creates a realm name, then assigns FQDNs to all of the computers that transact diameter traffic. The number of computers in the Diameter Realm depends on the number and type of diameter services the operator intends to support, as well as the expected volume of diameter traffic. Typically, load-sharing and redundancy are major factors governing the internal organization of a Diameter Realm.
The dynamic discovery of remote hosts is always undertaken within a single realm. Many realms can be discovered dynamically, but the discovery of one realm is a process independent of that for all other realms that are to be discovered.
/diameter/dpdrealms
get /diameter/dpdrealms
Returns all Realms configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Realms meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/dpdrealmCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id":"http://dsr.cgbu.oracle.com/schemas/diameter/dpdrealm/dpdrealm.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"realmDesc":{
"description":"This description exists to store any user-useful details about the Realm.",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
},
"realmName":{
"description":"A valid Realm Name",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
}
},
"required":[
"realmName"
],
"type":"object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel" : "68",
"realmDesc" : "New Realm",
"realmName" : "realm123"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/dpdrealms
Adds a new Realm to the DSR configuration. The new Realm must have a name that is unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id":"http://dsr.cgbu.oracle.com/schemas/diameter/dpdrealm/dpdrealm.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"realmDesc":{
"description":"This description exists to store any user-useful details about the Realm.",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
},
"realmName":{
"description":"A valid Realm Name",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
}
},
"required":[
"realmName"
],
"type":"object"
}
Example
{
"configurationLevel" : "68",
"realmDesc" : "New Realm",
"realmName" : "realm123"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/dpdrealms/{realm}
get /diameter/dpdrealms/{realm}
Returns the configuration details for the specified Realm. If the specified Realm does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- realm: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/dpdrealmItem.json",
"type": "object",
"properties": {
"data":
{
"id":"http://dsr.cgbu.oracle.com/schemas/diameter/dpdrealm/dpdrealm.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"realmDesc":{
"description":"This description exists to store any user-useful details about the Realm.",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
},
"realmName":{
"description":"A valid Realm Name",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
}
},
"required":[
"realmName"
],
"type":"object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel" : "68",
"realmDesc" : "New Realm",
"realmName" : "realm123"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/dpdrealms/{realm}
Updates the configuration for the specified Realm. If the provided Realm data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- realm: required (string)
Body
Type: application/json
Schema
{
"id":"http://dsr.cgbu.oracle.com/schemas/diameter/dpdrealm/dpdrealm.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"realmDesc":{
"description":"This description exists to store any user-useful details about the Realm.",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
},
"realmName":{
"description":"A valid Realm Name",
"maxLength":255,
"minLength": 1,
"pattern": "^([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*)|(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
}
},
"required":[
"realmName"
],
"type":"object"
}
Example
{
"configurationLevel" : "68",
"realmDesc" : "New Realm",
"realmName" : "realm123"
}
delete /diameter/dpdrealms/{realm}
Deletes the specified Realm from the SOAM configuration. A Realm will only be deleted if all delete validation checks pass. If the Realm is part of the configuration of some other Managed Object, it cannot be deleted. For example, if the Realm is associated with a Discovery Attribute (/diameter/dpdattributesets), that association must first be removed (either by editing the Discovery Attribute and choosing a different Realm, or deleting the Realm entirely). Then the Realm can be deleted from the configuration. An attempt to delete the Realm that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- realm: required (string)
Diameter: Peer Discovery DNS Sets
This DNS Sets page shows all DNS Sets configured for potential Dynamic Peer Discovery.
/diameter/dpddnssets
get /diameter/dpddnssets
Returns all the DNS set present in DSR configuration.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/dpddnssetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dpddnsset/dpddnsset.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dnsSetName":{
"description":"Name of the DNS Set.",
"maxlength":32,
"minlength":1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type":"string"
},
"numRetries":{
"description":"Specifies how many times the application retires if the DNA query times out.",
"maximum":3,
"minimum":1,
"type":"integer"
},
"primaryIp":{
"description":"The IP address of the primary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
},
"queryTimeOut":{
"description":"Specifies how long the application waits for a response from the DNS server.",
"maximum":4,
"minimum":1,
"type":"integer"
},
"secondaryIp":{
"description":"The IP address of the secondary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs. The secondary DNS server is only queried if the query to the primary DNS server times out.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
}
},
"required":[
"dnsSetName",
"numRetries",
"primaryIp",
"queryTimeOut"
],
"type":"object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"dnsSetName": "testSet",
"numRetries": 2,
"primaryIp": "1.2.3.4",
"queryTimeOut": 2,
"secondaryIp": "2.3.4.5"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/dpddnssets
Adds a new DNS set to the DSR configuration. The new DNS set must have a name that is unique to the SOAM's configuration.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dpddnsset/dpddnsset.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dnsSetName":{
"description":"Name of the DNS Set.",
"maxlength":32,
"minlength":1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type":"string"
},
"numRetries":{
"description":"Specifies how many times the application retires if the DNA query times out.",
"maximum":3,
"minimum":1,
"type":"integer"
},
"primaryIp":{
"description":"The IP address of the primary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
},
"queryTimeOut":{
"description":"Specifies how long the application waits for a response from the DNS server.",
"maximum":4,
"minimum":1,
"type":"integer"
},
"secondaryIp":{
"description":"The IP address of the secondary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs. The secondary DNS server is only queried if the query to the primary DNS server times out.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
}
},
"required":[
"dnsSetName",
"numRetries",
"primaryIp",
"queryTimeOut"
],
"type":"object"
}
Example
{
"configurationLevel": "0",
"dnsSetName": "testSet",
"numRetries": 2,
"primaryIp": "1.2.3.4",
"queryTimeOut": 2,
"secondaryIp": "2.3.4.5"
}
Response
HTTP status code 201
/diameter/dpddnssets/{name}
get /diameter/dpddnssets/{name}
Returns the configuration details for the specified DNS set. If the specified Realm does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/dpddnssetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dpddnsset/dpddnsset.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dnsSetName":{
"description":"Name of the DNS Set.",
"maxlength":32,
"minlength":1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type":"string"
},
"numRetries":{
"description":"Specifies how many times the application retires if the DNA query times out.",
"maximum":3,
"minimum":1,
"type":"integer"
},
"primaryIp":{
"description":"The IP address of the primary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
},
"queryTimeOut":{
"description":"Specifies how long the application waits for a response from the DNS server.",
"maximum":4,
"minimum":1,
"type":"integer"
},
"secondaryIp":{
"description":"The IP address of the secondary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs. The secondary DNS server is only queried if the query to the primary DNS server times out.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
}
},
"required":[
"dnsSetName",
"numRetries",
"primaryIp",
"queryTimeOut"
],
"type":"object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"dnsSetName": "testSet",
"numRetries": 2,
"primaryIp": "1.2.3.4",
"queryTimeOut": 2,
"secondaryIp": "2.3.4.5"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/dpddnssets/{name}
Updates the DNS set with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dpddnsset/dpddnsset.json",
"properties":{
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dnsSetName":{
"description":"Name of the DNS Set.",
"maxlength":32,
"minlength":1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type":"string"
},
"numRetries":{
"description":"Specifies how many times the application retires if the DNA query times out.",
"maximum":3,
"minimum":1,
"type":"integer"
},
"primaryIp":{
"description":"The IP address of the primary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
},
"queryTimeOut":{
"description":"Specifies how long the application waits for a response from the DNS server.",
"maximum":4,
"minimum":1,
"type":"integer"
},
"secondaryIp":{
"description":"The IP address of the secondary DNS server the DSR uses when it needs to resolve Peer Node (/diameter/peernodes) FQDNs. The secondary DNS server is only queried if the query to the primary DNS server times out.",
"pattern":"^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type":"string"
}
},
"required":[
"dnsSetName",
"numRetries",
"primaryIp",
"queryTimeOut"
],
"type":"object"
}
Example
{
"configurationLevel": "0",
"dnsSetName": "testSet",
"numRetries": 2,
"primaryIp": "1.2.3.4",
"queryTimeOut": 2,
"secondaryIp": "2.3.4.5"
}
delete /diameter/dpddnssets/{name}
Deletes the specified DNS set from the SOAM configuration.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Egress Message Throttling Configuration Sets
Egress Message Throttling Configuration Sets provide a mechanism for managing egress message traffic on Diameter Connections (/diameter/connections). An Egress Message Throttling Configuration Set is configured with a maximum allowable Egress Message Rate (EMR) and one to three pairs of throttling and abatement thresholds. Any Connection to which the configuration set is applied is then subject to egress message throttling, based on the parameters specified in the configuration set.
When the EMR on a Connection exceeds a throttling threshold value, the EMR congestion level for the Connection is increased. When the EMR on a Connection falls below an abatement threshold for the abatement time, the EMR congestion level is decreased. DSR throttles the addition of new request messages on a Connection that is experiencing congestion.
All configuration of Egress Messege Throttling Configuration Sets is done at the SOAM.
/diameter/egressmessagethrottlingconfigurationsets
get /diameter/egressmessagethrottlingconfigurationsets
Returns all Egress Message Throttling Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Egress Message Throttling Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/egressmessagethrottlingconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressmessagethrottlingconfigurationset/egressmessagethrottlingconfigurationset.json",
"properties": {
"abatementTime": {
"description": "The time, in milliseconds, a throttled Connection's (/diameter/connections) calculated Egress Message Rate (EMR) must remain below an abatement level before the Connection's congestion level is reduced. Typical value is 500 msec.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"abatementThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh1 for abatementTime milliseconds, the Connection's congestion level is lowered to 0. Typical value is 80.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"abatementThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh2 for abatementTime milliseconds, the Connection's congestion level is lowered to 1.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"abatementThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh3 for abatementTime milliseconds, the Connection's congestion level is lowered to 2.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded on a Connection (/diameter/connections) per unit time - the Egress Message Rate, or EMR. The time interval the DSR algorithm uses when calculating this rate - effectively a sample period - is specified by the convergenceTime value, which is in milliseconds. If convergenceTime is less than 1000 msec - meaning the sample period is less than one full second - the DSR extrapolates the per-second rate based on the observed egress request messages during the sample period. If convergenceTime is 1000 msec, then the rate is just the observed egress request messages during that 1000 msec interval. If convergenceTime is greater than 1000 msec, the rate is the average of the one-second intervals within the convergenceTime duration. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"maxEgressMessageRate": {
"description": "The maximum allowed Egress Message Rate (EMR) on a Connection (/diameter/connections) that can be throttled.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for this Egress Message Throttling Configuration Set, which must be unique within the DSR site. A name is required, and cannot be changed after the configuration set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate increases above throttleThresh1, the Connection's congestion level is raised to 1. Typical value is 100, which means that when the Connection's EMR exceeds maxEgressMessageRate, the Connection enters CL1 and the DSR sends no new requests on the Connection until abatement is achieved.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"throttleThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh2, the Connection's congestion level is raised to 2.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"throttleThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh3, the Connection's congestion level is raised to 3.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"abatementThresh1",
"abatementTime",
"convergenceTime",
"maxEgressMessageRate",
"name",
"throttleThresh1"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"abatementTime": 500,
"abatementThresh1": 80,
"abatementThresh2": 90,
"abatementThresh3": 95,
"configurationLevel": "27560",
"convergenceTime": 250,
"maxEgressMessageRate": 5000,
"name": "EMTCfgSet1",
"throttleThresh1": 85,
"throttleThresh2": 92,
"throttleThresh3": 98
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/egressmessagethrottlingconfigurationsets
Adds a new Egress Message Throttling Configuration Set to the DSR configuration. The new Egress Message Throttling Configuration Set must have a name that is unique across all Egress Message Throttling Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressmessagethrottlingconfigurationset/egressmessagethrottlingconfigurationset.json",
"properties": {
"abatementTime": {
"description": "The time, in milliseconds, a throttled Connection's (/diameter/connections) calculated Egress Message Rate (EMR) must remain below an abatement level before the Connection's congestion level is reduced. Typical value is 500 msec.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"abatementThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh1 for abatementTime milliseconds, the Connection's congestion level is lowered to 0. Typical value is 80.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"abatementThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh2 for abatementTime milliseconds, the Connection's congestion level is lowered to 1.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"abatementThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh3 for abatementTime milliseconds, the Connection's congestion level is lowered to 2.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded on a Connection (/diameter/connections) per unit time - the Egress Message Rate, or EMR. The time interval the DSR algorithm uses when calculating this rate - effectively a sample period - is specified by the convergenceTime value, which is in milliseconds. If convergenceTime is less than 1000 msec - meaning the sample period is less than one full second - the DSR extrapolates the per-second rate based on the observed egress request messages during the sample period. If convergenceTime is 1000 msec, then the rate is just the observed egress request messages during that 1000 msec interval. If convergenceTime is greater than 1000 msec, the rate is the average of the one-second intervals within the convergenceTime duration. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"maxEgressMessageRate": {
"description": "The maximum allowed Egress Message Rate (EMR) on a Connection (/diameter/connections) that can be throttled.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for this Egress Message Throttling Configuration Set, which must be unique within the DSR site. A name is required, and cannot be changed after the configuration set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate increases above throttleThresh1, the Connection's congestion level is raised to 1. Typical value is 100, which means that when the Connection's EMR exceeds maxEgressMessageRate, the Connection enters CL1 and the DSR sends no new requests on the Connection until abatement is achieved.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"throttleThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh2, the Connection's congestion level is raised to 2.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"throttleThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh3, the Connection's congestion level is raised to 3.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"abatementThresh1",
"abatementTime",
"convergenceTime",
"maxEgressMessageRate",
"name",
"throttleThresh1"
],
"type": "object"
}
Example
{
"abatementTime": 500,
"abatementThresh1": 80,
"abatementThresh2": 90,
"abatementThresh3": 95,
"configurationLevel": "27560",
"convergenceTime": 250,
"maxEgressMessageRate": 5000,
"name": "EMTCfgSet1",
"throttleThresh1": 85,
"throttleThresh2": 92,
"throttleThresh3": 98
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/egressmessagethrottlingconfigurationsets/{name}
get /diameter/egressmessagethrottlingconfigurationsets/{name}
Returns the configuration details for the specified Egress Message Throttling Configuration Set. If the Egress Message Throttling Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/egressmessagethrottlingconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressmessagethrottlingconfigurationset/egressmessagethrottlingconfigurationset.json",
"properties": {
"abatementTime": {
"description": "The time, in milliseconds, a throttled Connection's (/diameter/connections) calculated Egress Message Rate (EMR) must remain below an abatement level before the Connection's congestion level is reduced. Typical value is 500 msec.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"abatementThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh1 for abatementTime milliseconds, the Connection's congestion level is lowered to 0. Typical value is 80.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"abatementThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh2 for abatementTime milliseconds, the Connection's congestion level is lowered to 1.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"abatementThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh3 for abatementTime milliseconds, the Connection's congestion level is lowered to 2.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded on a Connection (/diameter/connections) per unit time - the Egress Message Rate, or EMR. The time interval the DSR algorithm uses when calculating this rate - effectively a sample period - is specified by the convergenceTime value, which is in milliseconds. If convergenceTime is less than 1000 msec - meaning the sample period is less than one full second - the DSR extrapolates the per-second rate based on the observed egress request messages during the sample period. If convergenceTime is 1000 msec, then the rate is just the observed egress request messages during that 1000 msec interval. If convergenceTime is greater than 1000 msec, the rate is the average of the one-second intervals within the convergenceTime duration. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"maxEgressMessageRate": {
"description": "The maximum allowed Egress Message Rate (EMR) on a Connection (/diameter/connections) that can be throttled.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for this Egress Message Throttling Configuration Set, which must be unique within the DSR site. A name is required, and cannot be changed after the configuration set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate increases above throttleThresh1, the Connection's congestion level is raised to 1. Typical value is 100, which means that when the Connection's EMR exceeds maxEgressMessageRate, the Connection enters CL1 and the DSR sends no new requests on the Connection until abatement is achieved.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"throttleThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh2, the Connection's congestion level is raised to 2.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"throttleThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh3, the Connection's congestion level is raised to 3.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"abatementThresh1",
"abatementTime",
"convergenceTime",
"maxEgressMessageRate",
"name",
"throttleThresh1"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"abatementTime": 500,
"abatementThresh1": 80,
"abatementThresh2": 90,
"abatementThresh3": 95,
"configurationLevel": "27560",
"convergenceTime": 250,
"maxEgressMessageRate": 5000,
"name": "EMTCfgSet1",
"throttleThresh1": 85,
"throttleThresh2": 92,
"throttleThresh3": 98
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/egressmessagethrottlingconfigurationsets/{name}
Updates the configuration of the specified Egress Message Throttling Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressmessagethrottlingconfigurationset/egressmessagethrottlingconfigurationset.json",
"properties": {
"abatementTime": {
"description": "The time, in milliseconds, a throttled Connection's (/diameter/connections) calculated Egress Message Rate (EMR) must remain below an abatement level before the Connection's congestion level is reduced. Typical value is 500 msec.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"abatementThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh1 for abatementTime milliseconds, the Connection's congestion level is lowered to 0. Typical value is 80.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"abatementThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh2 for abatementTime milliseconds, the Connection's congestion level is lowered to 1.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"abatementThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate falls below abatementThresh3 for abatementTime milliseconds, the Connection's congestion level is lowered to 2.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"convergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded on a Connection (/diameter/connections) per unit time - the Egress Message Rate, or EMR. The time interval the DSR algorithm uses when calculating this rate - effectively a sample period - is specified by the convergenceTime value, which is in milliseconds. If convergenceTime is less than 1000 msec - meaning the sample period is less than one full second - the DSR extrapolates the per-second rate based on the observed egress request messages during the sample period. If convergenceTime is 1000 msec, then the rate is just the observed egress request messages during that 1000 msec interval. If convergenceTime is greater than 1000 msec, the rate is the average of the one-second intervals within the convergenceTime duration. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"maxEgressMessageRate": {
"description": "The maximum allowed Egress Message Rate (EMR) on a Connection (/diameter/connections) that can be throttled.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"name": {
"description": "Name for this Egress Message Throttling Configuration Set, which must be unique within the DSR site. A name is required, and cannot be changed after the configuration set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleThresh1": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rate increases above throttleThresh1, the Connection's congestion level is raised to 1. Typical value is 100, which means that when the Connection's EMR exceeds maxEgressMessageRate, the Connection enters CL1 and the DSR sends no new requests on the Connection until abatement is achieved.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"throttleThresh2": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh2, the Connection's congestion level is raised to 2.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"throttleThresh3": {
"description": "A percentage of maxEgressMessageRate. When a Connection's (/diameter/connections) Egress Message Rat e increases above throttleThresh3, the Connection's congestion level is raised to 3.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"abatementThresh1",
"abatementTime",
"convergenceTime",
"maxEgressMessageRate",
"name",
"throttleThresh1"
],
"type": "object"
}
Example
{
"abatementTime": 500,
"abatementThresh1": 80,
"abatementThresh2": 90,
"abatementThresh3": 95,
"configurationLevel": "27560",
"convergenceTime": 250,
"maxEgressMessageRate": 5000,
"name": "EMTCfgSet1",
"throttleThresh1": 85,
"throttleThresh2": 92,
"throttleThresh3": 98
}
delete /diameter/egressmessagethrottlingconfigurationsets/{name}
Deletes the specified Egress Message Throttling Configuration Set from the SOAM configuration. An Egress Message Throttling Configuration Set can only be deleted if all delete validation checks pass. In general, if the Egress Message Throttling Configuration Set is part of the configuration of one or more Connections (/diameter/connections), the Egress Message Throttling Configuration Set cannot be deleted. If the Egress Message Throttling Configuration Set is named in a Connection, the Egress Message Throttling Configuration Set must first be removed from the Connection. Then the Egress Message Throttling Configuration Set can be deleted from the configuration. An attempt to delete a Egress Message Throttling Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Egress Throttle Groups
An Egress Throttle Group (ETG) is a collection of 1 to 128 Diameter Connections (/diameter/connections), or Peer Nodes (/diameter/peernodes), or both that are logically grouped to monitor egress message rate and egress pending transactions. ETG rate limiting and pending transaction limiting throttling are done for request messages only. An ETG is independent of a Route Group (/diameter/routegroups). As the ETG's congestion level increases, message priority determines if a message can be routed to a member of the ETG, or becomes throttled.
Each ETG has its own congestion level state based on its configuration. A maximum of four congestions levels (CL0 to CL3) is supported. CL0 indicates the resource has no congestion, while CL3 is the highest level of congestion. Diameter request messages are assigned a priority of 0, 1, 2, or 4. When an ETG is at congestion level N, only request messages having priority at or above N are sent by the DSR.
An ETG can be standalone or it can be associated with an Egress Throttle List (/diameter/egressthrottlelists) that spans mated DSR sites. An ETG can be associated with only one Egress Throttle List.
All configuration of Egress Throttle Groups is done at the SOAM.
/diameter/egressthrottlegroups
get /diameter/egressthrottlegroups
Returns all Egress Throttle Groups configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Egress Throttle Groups meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/egressthrottlegroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlegroup/egressthrottlegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionName": {
"description": "The Connection (/diameter/connections) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections and Peer Nodes (/diameter/peernodes) associated with an ETG, there can be up to 128 individual Connections in the connectionName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Connection (/diameter/connections) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"etgControlScope": {
"description": "The DSR uses etgControlScope when deciding to use ETG data or aggregated data from the parent Egress Throttle List (/diameter/egressthrottlelists) in throttling decisions.",
"enum": [
"Etg",
"Etl"
],
"type": "string"
},
"name": {
"description": "Name for the Egress Throttle Group, which must be unique within the DSR site. A name is required and cannot be changed after the Egress Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "The Peer Node (/diameter/peernodes) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections (/diameter/connections) and Peer Nodes associated with an ETG, there can be up to 128 individual Peer Nodes in the peerNodeName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Peer Node (/diameter/peernodes) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"etgControlScope",
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "2",
"connectionName": [
"AF01",
"AF02"
],
"etgControlScope": "Etg",
"name": "EgressThrottlingGroup1",
"peerNodeName": [
"AF04",
"AF05"
],
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/egressthrottlegroups
Adds a new Egress Throttle Group to the DSR configuration. The new ETG must have a name that is unique across all ETGs at the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlegroup/egressthrottlegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionName": {
"description": "The Connection (/diameter/connections) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections and Peer Nodes (/diameter/peernodes) associated with an ETG, there can be up to 128 individual Connections in the connectionName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Connection (/diameter/connections) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"etgControlScope": {
"description": "The DSR uses etgControlScope when deciding to use ETG data or aggregated data from the parent Egress Throttle List (/diameter/egressthrottlelists) in throttling decisions.",
"enum": [
"Etg",
"Etl"
],
"type": "string"
},
"name": {
"description": "Name for the Egress Throttle Group, which must be unique within the DSR site. A name is required and cannot be changed after the Egress Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "The Peer Node (/diameter/peernodes) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections (/diameter/connections) and Peer Nodes associated with an ETG, there can be up to 128 individual Peer Nodes in the peerNodeName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Peer Node (/diameter/peernodes) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"etgControlScope",
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName"
],
"type": "object"
}
Example
{
"configurationLevel": "2",
"connectionName": [
"AF01",
"AF02"
],
"etgControlScope": "Etg",
"name": "EgressThrottlingGroup1",
"peerNodeName": [
"AF04",
"AF05"
],
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/egressthrottlegroups/status
get /diameter/egressthrottlegroups/status
Returns the status of all Egress Throttle Groups that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, or IN. LIKE is not supported for these data types.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=numberPendingEtgTransactions
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=99
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/egressthrottlegroupstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlegroup/egressthrottlegroupstatus.json",
"properties": {
"averagePendTransHoldTime": {
"description": "The average transaction hold time for recently completed egress transactions associated with the ETG/ETL.",
"type": "integer"
},
"egressRequestRate": {
"description": "The egress request rate (in messages/second) to the Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) that are members of the Egress Throttle Group. If etgControlScope value (/diameter/egressthrottlegroups) is set to Etg, then this attribute value is equal to etgEgressRequestRate attribute value, else if etgControlScope value (/diameter/egressthrottlegroups) is set to Etl, then this attribute value is equal to etlEgressRequestRate attribute value.",
"type": "integer"
},
"etgEgressRequestRate": {
"description": "The egress request rate (in messages/second) to the Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) that are members of the Egress Throttle Group.",
"type": "integer"
},
"etlEgressRequestRate": {
"description": "The egress request rate (in messages/second) to the Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) that are members of an Egress Throttle List's (/diameter/egressthrottlelists) component Egress Throttle Groups.",
"type": "integer"
},
"name": {
"description": "The configured name of the Egress Throttle Group.",
"type": "string"
},
"numberActiveSmsConnections": {
"description": "The current number of active SMS connections between signaling routers with Egress Throttle Groups in an Egress Throttle List (/diameter/egressthrottlelists).",
"maximum": 2,
"minimum": 0,
"type": "integer"
},
"numberPendingEtgTransactions": {
"description": "The number of pending transactions for both Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) configured for this ETG.",
"type": "integer"
},
"numberPendingEtlTransactions": {
"description": "The number of pending transactions for both Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) configured to each Egress Throttle Group configured for an Egress Throttle List (/diameter/egressthrottlelists).",
"type": "integer"
},
"numberOfPendingTransactions": {
"description": "The number of pending transactions for both Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) configured for this ETG or to each Egress Throttle Group configured for an Egress Throttle List. If etgControlScope value (/diameter/egressthrottlegroups) is set to Etg, then this attribute value is equal to numberPendingEtgTransactions attribute value, else if etgControlScope value (/diameter/egressthrottlegroups) is set to Etl, then this attribute value is equal to numberPendingEtlTransactions attribute value.",
"type": "integer"
},
"offeredTrafficRate": {
"description": "The rate of transactions which are being routed to the ETG/ETL before diversion is applied.",
"type": "integer"
},
"pendingTransactionLimitingAdminState": {
"description": "The pending transaction limiting administrative state for this Egress Throttle Group. When pendingTransactionLimitingAdminState is set to Disabled, the DSR does not throttle requests based on the current number of pending transactions. pendingTransactionLimitingAdminState must first be set to Enabled before any throttling is performed.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"pendingTransactionLimitingOperationalReason": {
"description": "Information elaborating on the current pendingTransactionLimitingOperationalStatus of this Egress Throttle Group.",
"type": "string"
},
"pendingTransactionLimitingOperationalStatus": {
"description": "The pending transaction limiting operational status for this Egress Throttle Group. The pendingTransactionLimitingOperationalReason value contains additional information elaborating on the reported pendingTransactionLimitingOperationalStatus.",
"enum": [
"Available",
"Degraded",
"Inactive",
"Unknown"
],
"type": "string"
},
"percentTransDiverted": {
"description": "The percentage of transactions which are being routed to the ETG/ETL which are being diverted.",
"type": "integer",
"maximum": 100,
"minimum": 0
},
"rateLimitingAdminState": {
"description": "The rate limiting administrative state for this Egress Throttle Group. When rateLimitingAdminState is set to Disabled, the DSR does not throttle traffic based on request rate. rateLimitingAdminState must first be set to Enabled before limiting the rate.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"rateLimitingOperationalReason": {
"description": "Information elaborating on the current rateLimitingOperationalStatus of this Egress Throttle Group.",
"type": "string"
},
"rateLimitingOperationalStatus": {
"description": "The current rate limiting operational state of this Egress Throttle Group. The rateLimitingOperationalReason value contains additional information elaborating on the reported rateLimitingOperationalStatus.",
"enum": [
"Available",
"Degraded",
"Inactive"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this ETG are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this ETG. If the OAM has current status for this ETG, statusKnown is set to true.",
"type": "boolean"
},
"targetEtr": {
"description": "If both rate limiting and pending transaction limiting are enabled for this ETG/ETL, the targetEtr is a computed value that is equal to the lesser of the rate limiting Egress Throttle Rate (ETR) and the pending transaction limiting ETR. If only rate limiting or pending transaction limiting is enabled for this ETG/ETL, then the targetEtr is the target ETR for the type of functionality that is enabled.",
"type": "integer"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Egress Throttle Group (/diameter/egressthrottlegroups) was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"etgEgressRequestRate": 4,
"etlEgressRequestRate": 23,
"name": "egressthrottlegroupstatus1",
"numberActiveSmsConnections": 2,
"numberPendingEtgTransactions": 34,
"numberPendingEtlTransactions": 2,
"pendingTransactionLimitingAdminState": "Enabled",
"pendingTransactionLimitingOperationalReason": "Normal",
"pendingTransactionLimitingOperationalStatus": "Available",
"rateLimitingAdminState": "Enabled",
"rateLimitingOperationalReason": "Normal",
"rateLimitingOperationalStatus": "Available",
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/egressthrottlegroups/{name}
get /diameter/egressthrottlegroups/{name}
Returns the configuration details for the specified Egress Throttle Group. If the specified ETG does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/egressthrottlegroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlegroup/egressthrottlegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionName": {
"description": "The Connection (/diameter/connections) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections and Peer Nodes (/diameter/peernodes) associated with an ETG, there can be up to 128 individual Connections in the connectionName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Connection (/diameter/connections) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"etgControlScope": {
"description": "The DSR uses etgControlScope when deciding to use ETG data or aggregated data from the parent Egress Throttle List (/diameter/egressthrottlelists) in throttling decisions.",
"enum": [
"Etg",
"Etl"
],
"type": "string"
},
"name": {
"description": "Name for the Egress Throttle Group, which must be unique within the DSR site. A name is required and cannot be changed after the Egress Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "The Peer Node (/diameter/peernodes) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections (/diameter/connections) and Peer Nodes associated with an ETG, there can be up to 128 individual Peer Nodes in the peerNodeName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Peer Node (/diameter/peernodes) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"etgControlScope",
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "2",
"connectionName": [
"AF01",
"AF02"
],
"etgControlScope": "Etg",
"name": "EgressThrottlingGroup1",
"peerNodeName": [
"AF04",
"AF05"
],
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/egressthrottlegroups/{name}
Updates the configuration for the specified Egress Throttle Group. If the provided ETG data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlegroup/egressthrottlegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionName": {
"description": "The Connection (/diameter/connections) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections and Peer Nodes (/diameter/peernodes) associated with an ETG, there can be up to 128 individual Connections in the connectionName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Connection (/diameter/connections) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"etgControlScope": {
"description": "The DSR uses etgControlScope when deciding to use ETG data or aggregated data from the parent Egress Throttle List (/diameter/egressthrottlelists) in throttling decisions.",
"enum": [
"Etg",
"Etl"
],
"type": "string"
},
"name": {
"description": "Name for the Egress Throttle Group, which must be unique within the DSR site. A name is required and cannot be changed after the Egress Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "The Peer Node (/diameter/peernodes) names associated with the Egress Throttle Group. Because there can be a total of 128 Connections (/diameter/connections) and Peer Nodes associated with an ETG, there can be up to 128 individual Peer Nodes in the peerNodeName list. Any Connection to a Peer Node listed in peerNodeName is implicitly included in the ETG and should not need be included in the connectionName list.",
"items": {
"description": "Name of an individual Peer Node (/diameter/peernodes) that is part of this ETG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"type": "array"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) associated with this TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"etgControlScope",
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName"
],
"type": "object"
}
Example
{
"configurationLevel": "2",
"connectionName": [
"AF01",
"AF02"
],
"etgControlScope": "Etg",
"name": "EgressThrottlingGroup1",
"peerNodeName": [
"AF04",
"AF05"
],
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default"
}
delete /diameter/egressthrottlegroups/{name}
Deletes the specified Egress Throttle Group from the SOAM configuration. An ETG can only be deleted if all delete validation checks pass. In general, the ETG cannot be deleted if either the Rate Limiting Admin State or Pending Transaction Limiting Admin State is not in the disabled state; or the ETG is configured in an Egress Throttle List (/diameter/egressthrottlelists). For example, if the ETG is named in a Egress Throttle List, the ETG must first be removed from the Egress Throttle List at the NOAM. Then the ETG can be deleted from the configuration. An attempt to delete an ETG that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/diameter/egressthrottlegroups/{name}/ratelimitingadminstate
get /diameter/egressthrottlegroups/{name}/ratelimitingadminstate
Retrieves the rate limiting administrative state for the specified Egress Throttle Group, which can be Enabled or Disabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/ratelimitingadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ratelimitingadminstate/ratelimitingadminstate.json",
"properties": {
"adminState": {
"description": "An Egress Throttle Group's rate limiting administrative state can be either Enabled or Disabled. An Egress Throttle Group's configuration cannot be modified, nor can the Egress Throttle Group be deleted from the DSR configuration, if its rate limiting administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/egressthrottlegroups/{name}/ratelimitingadminstate
Updates the rate limiting administrative state for the specified Egress Throttle Group to either Enabled or Disabled.
An Egress Throttle Group's configuration cannot be modified, nor can the Egress Throttle Group be deleted from the DSR configuration, if its rate limiting administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ratelimitingadminstate/ratelimitingadminstate.json",
"properties": {
"adminState": {
"description": "An Egress Throttle Group's rate limiting administrative state can be either Enabled or Disabled. An Egress Throttle Group's configuration cannot be modified, nor can the Egress Throttle Group be deleted from the DSR configuration, if its rate limiting administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
/diameter/egressthrottlegroups/{name}/pendingtransactionlimitingadminstate
get /diameter/egressthrottlegroups/{name}/pendingtransactionlimitingadminstate
Retrieves the pending transaction limiting administrative state for the specified Egress Throttle Group, which can be Enabled or Disabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/pendingtransactionlimitingadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendingtransactionlimitingadminstate/pendingtransactionlimitingadminstate.json",
"properties": {
"adminState": {
"description": "An Egress Throttle Group's pending transaction limiting administrative state can be either Enabled or Disabled. An Egress Throttle Group's configuration cannot be modified, nor can the Egress Throttle Group be deleted from the DSR configuration, if its pending transaction limiting administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/egressthrottlegroups/{name}/pendingtransactionlimitingadminstate
Updates the pending transaction limiting administrative state for the specified Egress Throttle Group to either Enabled or Disabled.
An Egress Throttle Group's configuration cannot be modified, nor can the Egress Throttle Group be deleted from the DSR configuration, if its pending transaction limiting administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendingtransactionlimitingadminstate/pendingtransactionlimitingadminstate.json",
"properties": {
"adminState": {
"description": "An Egress Throttle Group's pending transaction limiting administrative state can be either Enabled or Disabled. An Egress Throttle Group's configuration cannot be modified, nor can the Egress Throttle Group be deleted from the DSR configuration, if its pending transaction limiting administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
/diameter/egressthrottlegroups/{name}/status
get /diameter/egressthrottlegroups/{name}/status
Retrieves the operational status for the specified Egress Throttle Group.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/egressthrottlegroupstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlegroup/egressthrottlegroupstatus.json",
"properties": {
"averagePendTransHoldTime": {
"description": "The average transaction hold time for recently completed egress transactions associated with the ETG/ETL.",
"type": "integer"
},
"egressRequestRate": {
"description": "The egress request rate (in messages/second) to the Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) that are members of the Egress Throttle Group. If etgControlScope value (/diameter/egressthrottlegroups) is set to Etg, then this attribute value is equal to etgEgressRequestRate attribute value, else if etgControlScope value (/diameter/egressthrottlegroups) is set to Etl, then this attribute value is equal to etlEgressRequestRate attribute value.",
"type": "integer"
},
"etgEgressRequestRate": {
"description": "The egress request rate (in messages/second) to the Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) that are members of the Egress Throttle Group.",
"type": "integer"
},
"etlEgressRequestRate": {
"description": "The egress request rate (in messages/second) to the Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) that are members of an Egress Throttle List's (/diameter/egressthrottlelists) component Egress Throttle Groups.",
"type": "integer"
},
"name": {
"description": "The configured name of the Egress Throttle Group.",
"type": "string"
},
"numberActiveSmsConnections": {
"description": "The current number of active SMS connections between signaling routers with Egress Throttle Groups in an Egress Throttle List (/diameter/egressthrottlelists).",
"maximum": 2,
"minimum": 0,
"type": "integer"
},
"numberPendingEtgTransactions": {
"description": "The number of pending transactions for both Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) configured for this ETG.",
"type": "integer"
},
"numberPendingEtlTransactions": {
"description": "The number of pending transactions for both Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) configured to each Egress Throttle Group configured for an Egress Throttle List (/diameter/egressthrottlelists).",
"type": "integer"
},
"numberOfPendingTransactions": {
"description": "The number of pending transactions for both Peer Nodes (/diameter/peernodes) and Connections (/diameter/connections) configured for this ETG or to each Egress Throttle Group configured for an Egress Throttle List. If etgControlScope value (/diameter/egressthrottlegroups) is set to Etg, then this attribute value is equal to numberPendingEtgTransactions attribute value, else if etgControlScope value (/diameter/egressthrottlegroups) is set to Etl, then this attribute value is equal to numberPendingEtlTransactions attribute value.",
"type": "integer"
},
"offeredTrafficRate": {
"description": "The rate of transactions which are being routed to the ETG/ETL before diversion is applied.",
"type": "integer"
},
"pendingTransactionLimitingAdminState": {
"description": "The pending transaction limiting administrative state for this Egress Throttle Group. When pendingTransactionLimitingAdminState is set to Disabled, the DSR does not throttle requests based on the current number of pending transactions. pendingTransactionLimitingAdminState must first be set to Enabled before any throttling is performed.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"pendingTransactionLimitingOperationalReason": {
"description": "Information elaborating on the current pendingTransactionLimitingOperationalStatus of this Egress Throttle Group.",
"type": "string"
},
"pendingTransactionLimitingOperationalStatus": {
"description": "The pending transaction limiting operational status for this Egress Throttle Group. The pendingTransactionLimitingOperationalReason value contains additional information elaborating on the reported pendingTransactionLimitingOperationalStatus.",
"enum": [
"Available",
"Degraded",
"Inactive",
"Unknown"
],
"type": "string"
},
"percentTransDiverted": {
"description": "The percentage of transactions which are being routed to the ETG/ETL which are being diverted.",
"type": "integer",
"maximum": 100,
"minimum": 0
},
"rateLimitingAdminState": {
"description": "The rate limiting administrative state for this Egress Throttle Group. When rateLimitingAdminState is set to Disabled, the DSR does not throttle traffic based on request rate. rateLimitingAdminState must first be set to Enabled before limiting the rate.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"rateLimitingOperationalReason": {
"description": "Information elaborating on the current rateLimitingOperationalStatus of this Egress Throttle Group.",
"type": "string"
},
"rateLimitingOperationalStatus": {
"description": "The current rate limiting operational state of this Egress Throttle Group. The rateLimitingOperationalReason value contains additional information elaborating on the reported rateLimitingOperationalStatus.",
"enum": [
"Available",
"Degraded",
"Inactive"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this ETG are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this ETG. If the OAM has current status for this ETG, statusKnown is set to true.",
"type": "boolean"
},
"targetEtr": {
"description": "If both rate limiting and pending transaction limiting are enabled for this ETG/ETL, the targetEtr is a computed value that is equal to the lesser of the rate limiting Egress Throttle Rate (ETR) and the pending transaction limiting ETR. If only rate limiting or pending transaction limiting is enabled for this ETG/ETL, then the targetEtr is the target ETR for the type of functionality that is enabled.",
"type": "integer"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Egress Throttle Group (/diameter/egressthrottlegroups) was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"etgEgressRequestRate": 4,
"etlEgressRequestRate": 23,
"name": "egressthrottlegroupstatus1",
"numberActiveSmsConnections": 2,
"numberPendingEtgTransactions": 34,
"numberPendingEtlTransactions": 2,
"pendingTransactionLimitingAdminState": "Enabled",
"pendingTransactionLimitingOperationalReason": "Normal",
"pendingTransactionLimitingOperationalStatus": "Available",
"rateLimitingAdminState": "Enabled",
"rateLimitingOperationalReason": "Normal",
"rateLimitingOperationalStatus": "Available",
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Egress Throttle Lists
An Egress Throttle List (ETL) is a collection of two or three Egress Throttle Groups (/diameter/egressthrottlegroups) (ETGs) configured at different DSR sites within the same network. An ETL controls egress message rate limiting and pending transaction limiting for component ETGs using run-time metrics to throttle request messages to Peer Nodes (/diameter/peernodes) and/or Connections (/diameter/connections) configured to the ETGs.
All Egress Throttle List configuration is done at the NOAM.
/diameter/egressthrottlelists
get /diameter/egressthrottlelists
Returns all Egress Throttle Lists configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Egress Throttle Lists meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/egressthrottlelistCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlelist/egressthrottlelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Egress Throttle List, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Pending Transaction Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Rate Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"etg": {
"description": "List of 2-3 Egress Throttle Groups (/diameter/egressthrottlegroups) from different sites. Entries in the Egress Throttle List can have the same egressThrottleGroupName as long as each has a unique siteName.",
"items": {
"properties": {
"connectionFailurePercentReduction": {
"description": "The percentage by which maximum rate and pending transactions are reduced if the connection between two sites in the Egress Throttle List fails. Typical value is 100 divided by the number of Egress Throttle Groups (/diameter/egressthrottlegroups) in ETL.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"egressThrottleGroupName": {
"description": "Name of an Egress Throttle Group (/diameter/egressthrottlegroups) associated with the Egress Throttle List.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this Egress Throttle Group (/diameter/egressthrottlegroups). No two ETGs in an Egress Throttle List can belong to the same site.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionFailurePercentReduction",
"egressThrottleGroupName",
"siteName"
],
"type": "object"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
}
},
"required": [
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName",
"etg"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "2",
"name": "EgressThrottleList1",
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default",
"etg": [
{
"connectionFailurePercentReduction": 50,
"egressThrottleGroupName": "EgressThrottleGroup1",
"siteName": "LEAF_SO_SG"
},
{
"connectionFailurePercentReduction": 30,
"egressThrottleGroupName": "EgressThrottleGroup2",
"siteName": "TREE_SO_SG"
}
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/egressthrottlelists
Adds a new Egress Throttle List to the DSR configuration. The new ETL must have a name that is unique across all ETLs at the NOAM's configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlelist/egressthrottlelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Egress Throttle List, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Pending Transaction Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Rate Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"etg": {
"description": "List of 2-3 Egress Throttle Groups (/diameter/egressthrottlegroups) from different sites. Entries in the Egress Throttle List can have the same egressThrottleGroupName as long as each has a unique siteName.",
"items": {
"properties": {
"connectionFailurePercentReduction": {
"description": "The percentage by which maximum rate and pending transactions are reduced if the connection between two sites in the Egress Throttle List fails. Typical value is 100 divided by the number of Egress Throttle Groups (/diameter/egressthrottlegroups) in ETL.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"egressThrottleGroupName": {
"description": "Name of an Egress Throttle Group (/diameter/egressthrottlegroups) associated with the Egress Throttle List.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this Egress Throttle Group (/diameter/egressthrottlegroups). No two ETGs in an Egress Throttle List can belong to the same site.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionFailurePercentReduction",
"egressThrottleGroupName",
"siteName"
],
"type": "object"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
}
},
"required": [
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName",
"etg"
],
"type": "object"
}
Example
{
"configurationLevel": "2",
"name": "EgressThrottleList1",
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default",
"etg": [
{
"connectionFailurePercentReduction": 50,
"egressThrottleGroupName": "EgressThrottleGroup1",
"siteName": "LEAF_SO_SG"
},
{
"connectionFailurePercentReduction": 30,
"egressThrottleGroupName": "EgressThrottleGroup2",
"siteName": "TREE_SO_SG"
}
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/egressthrottlelists/{name}
get /diameter/egressthrottlelists/{name}
Returns the configuration details for the specified Egress Throttle List. If the specified ETL does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/egressthrottlelistItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlelist/egressthrottlelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Egress Throttle List, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Pending Transaction Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Rate Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"etg": {
"description": "List of 2-3 Egress Throttle Groups (/diameter/egressthrottlegroups) from different sites. Entries in the Egress Throttle List can have the same egressThrottleGroupName as long as each has a unique siteName.",
"items": {
"properties": {
"connectionFailurePercentReduction": {
"description": "The percentage by which maximum rate and pending transactions are reduced if the connection between two sites in the Egress Throttle List fails. Typical value is 100 divided by the number of Egress Throttle Groups (/diameter/egressthrottlegroups) in ETL.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"egressThrottleGroupName": {
"description": "Name of an Egress Throttle Group (/diameter/egressthrottlegroups) associated with the Egress Throttle List.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this Egress Throttle Group (/diameter/egressthrottlegroups). No two ETGs in an Egress Throttle List can belong to the same site.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionFailurePercentReduction",
"egressThrottleGroupName",
"siteName"
],
"type": "object"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
}
},
"required": [
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName",
"etg"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "2",
"name": "EgressThrottleList1",
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default",
"etg": [
{
"connectionFailurePercentReduction": 50,
"egressThrottleGroupName": "EgressThrottleGroup1",
"siteName": "LEAF_SO_SG"
},
{
"connectionFailurePercentReduction": 30,
"egressThrottleGroupName": "EgressThrottleGroup2",
"siteName": "TREE_SO_SG"
}
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/egressthrottlelists/{name}
Updates the configuration for the specified Egress Throttle List. If the provided ETL data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/egressthrottlelist/egressthrottlelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with the Egress Throttle List, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingTransLimitingCfgSetName": {
"description": "Name of the Pending Transaction Limiting Configuration Set (/diameter/pendingtransactionlimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Pending Transaction Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateLimitingCfgSetName": {
"description": "Name of the Rate Limiting Configuration Set (/diameter/ratelimitingconfigurationsets) assigned to this Egress Throttle List. Note that only Rate Limiting Configuration Sets configured at the NOAM can be assigned to Egress Throttle Lists.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"etg": {
"description": "List of 2-3 Egress Throttle Groups (/diameter/egressthrottlegroups) from different sites. Entries in the Egress Throttle List can have the same egressThrottleGroupName as long as each has a unique siteName.",
"items": {
"properties": {
"connectionFailurePercentReduction": {
"description": "The percentage by which maximum rate and pending transactions are reduced if the connection between two sites in the Egress Throttle List fails. Typical value is 100 divided by the number of Egress Throttle Groups (/diameter/egressthrottlegroups) in ETL.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"egressThrottleGroupName": {
"description": "Name of an Egress Throttle Group (/diameter/egressthrottlegroups) associated with the Egress Throttle List.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this Egress Throttle Group (/diameter/egressthrottlegroups). No two ETGs in an Egress Throttle List can belong to the same site.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionFailurePercentReduction",
"egressThrottleGroupName",
"siteName"
],
"type": "object"
},
"maxItems": 3,
"minItems": 2,
"type": "array"
}
},
"required": [
"name",
"pendingTransLimitingCfgSetName",
"rateLimitingCfgSetName",
"etg"
],
"type": "object"
}
Example
{
"configurationLevel": "2",
"name": "EgressThrottleList1",
"pendingTransLimitingCfgSetName": "Default",
"rateLimitingCfgSetName": "Default",
"etg": [
{
"connectionFailurePercentReduction": 50,
"egressThrottleGroupName": "EgressThrottleGroup1",
"siteName": "LEAF_SO_SG"
},
{
"connectionFailurePercentReduction": 30,
"egressThrottleGroupName": "EgressThrottleGroup2",
"siteName": "TREE_SO_SG"
}
]
}
delete /diameter/egressthrottlelists/{name}
Deletes the specified Egress Throttle List (ETL) from the NOAM configuration. An ETL can only be deleted if each of its component Egress Throttle Groups (/diameter/egressthrottlegroups) is scoped to ETG. It is not necessary for the ETGs to be removed from the ETL's configuration before deleting the ETL; however, if any ETG in the ETL is scoped to ETL, that ETG's scope must first be changed to ETG. An attempt to delete an ETL that cannot be deleted results in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: S6a/S6d HSS Topology Hiding Configuration Sets
S6a/S6d HSS Topology Hiding Configuration Sets provide information that is used to perform S6a/S6d HSS Topology Hiding for Protected Networks. Each Protected Network can reference a single S6a/S6d HSS Topology Hiding Configuration Set.
All S6a/S6d HSS Topology Hiding Configuration Set configuration is done at the NOAM.
/diameter/hsstopologyhidingcfgsets
get /diameter/hsstopologyhidingcfgsets
Returns all S6a/S6d HSS Topology Hiding Configuration Sets configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those S6a/S6d HSS Topology Hiding Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/hsstopologyhidingcfgsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/hsstopologyhidingcfgset/hsstopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S6a/S6d HSS Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S6a/S6d HSS Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S6a/S6d HSS Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S6a/S6d HSS Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"singlePseudoHost": {
"description": "S6a/S6d HSS Pseudo Hostname. This Name will be used while replacing all HSS hostnames. S6a/S6d HSS Pseudo Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a S6a/S6d HSS Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"useSinglePseudoHost": {
"description": "When set to true, Single HSS Pseudo Hostname will be used for all HSS actual hostnames. When set to false, each Hss actual hostname will have its own set of pseudo hostnames.",
"default": true,
"type": "boolean"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestHssTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"useSinglePseudoHost": false,
"vendorId": 1001
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/hsstopologyhidingcfgsets
Adds a new S6a/S6d HSS Topology Hiding Configuration Set to the DSR configuration. The new S6a/S6d HSS Topology Hiding Configuration Set must have a name that is unique to the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/hsstopologyhidingcfgset/hsstopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S6a/S6d HSS Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S6a/S6d HSS Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S6a/S6d HSS Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S6a/S6d HSS Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"singlePseudoHost": {
"description": "S6a/S6d HSS Pseudo Hostname. This Name will be used while replacing all HSS hostnames. S6a/S6d HSS Pseudo Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a S6a/S6d HSS Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"useSinglePseudoHost": {
"description": "When set to true, Single HSS Pseudo Hostname will be used for all HSS actual hostnames. When set to false, each Hss actual hostname will have its own set of pseudo hostnames.",
"default": true,
"type": "boolean"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestHssTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"useSinglePseudoHost": false,
"vendorId": 1001
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/hsstopologyhidingcfgsets/{name}
get /diameter/hsstopologyhidingcfgsets/{name}
Returns the configuration details for the specified S6a/S6d HSS Topology Hiding Configuration Set. If the specified S6a/S6d HSS Topology Hiding Configuration Set does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/hsstopologyhidingcfgsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/hsstopologyhidingcfgset/hsstopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S6a/S6d HSS Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S6a/S6d HSS Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S6a/S6d HSS Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S6a/S6d HSS Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"singlePseudoHost": {
"description": "S6a/S6d HSS Pseudo Hostname. This Name will be used while replacing all HSS hostnames. S6a/S6d HSS Pseudo Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a S6a/S6d HSS Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"useSinglePseudoHost": {
"description": "When set to true, Single HSS Pseudo Hostname will be used for all HSS actual hostnames. When set to false, each Hss actual hostname will have its own set of pseudo hostnames.",
"default": true,
"type": "boolean"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestHssTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"useSinglePseudoHost": false,
"vendorId": 1001
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/hsstopologyhidingcfgsets/{name}
Updates the configuration for the specified S6a/S6d HSS Topology Hiding Configuration Set. If the provided S6a/S6d HSS Topology Hiding Configuration Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/hsstopologyhidingcfgset/hsstopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S6a/S6d HSS Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S6a/S6d HSS Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S6a/S6d HSS Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S6a/S6d HSS Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"singlePseudoHost": {
"description": "S6a/S6d HSS Pseudo Hostname. This Name will be used while replacing all HSS hostnames. S6a/S6d HSS Pseudo Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a S6a/S6d HSS Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"useSinglePseudoHost": {
"description": "When set to true, Single HSS Pseudo Hostname will be used for all HSS actual hostnames. When set to false, each Hss actual hostname will have its own set of pseudo hostnames.",
"default": true,
"type": "boolean"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestHssTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"useSinglePseudoHost": false,
"vendorId": 1001
}
delete /diameter/hsstopologyhidingcfgsets/{name}
Deletes the specified S6a/S6d HSS Topology Hiding Configuration Set from the NOAM configuration. An S6a/S6d HSS Topology Hiding Configuration Set can only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Local Nodes
A DSR site - the SOAM - is visible within the network as one or more Local Nodes. The Local Node managed object encapsulates all the characteristics of the DSR itself that must be known in order to configure transport connections to Peer Nodes (/diameter/peernodes). Each Local Node must have a unique Fully Qualified Domain Name (FQDN), although two or more Local Nodes may share the same Realm. A Local Node can support Diameter Connections (/diameter/connections), RADIUS Connections (/diameter/connections), or both, based on the role of the DSR within the network.
All Local Node configuration is done at the SOAM.
/diameter/localnodes
get /diameter/localnodes
Returns all Local Nodes configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Local Nodes meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/localnodeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/localnode/localnode.json",
"properties": {
"certName": {
"description": "A valid security certificate name.",
"maxLength": 255,
"type": "string"
},
"certType": {
"description": "The type of the security certificate identified by certName. DSR only supports certificate type Tls for assignment to a Local Node.",
"enum": [
"Tls"
],
"type": "string"
},
"certVerifyMode": {
"description": "The Certificate Verification Mode used when either a DTLS/SCTP or a TLS/TCP port is configured for this Local Node.",
"enum": [
"SslVerifyNone",
"SslVerifyPeer",
"SslVerifyPeerFailIfNoPeerCert",
"SslVerifyPeerVerifyClientOnce"
],
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/cexconfigurationsets) assigned to a Local Node supplies capabilities exchange parameters, which get applied to any Connection (/diameter/connections) that doesn't have its own CEX Configuration Set explicitly configured.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Local Node supplies default values for a variety of transport connection parameters. The only time a Local Node's Connection Configuration Set is used is when a responder-only Connection (/diameter/connections) is initially set up, awaiting establishment from a Peer Node (/diameter/peernodes). Once the responder-only Connection is established, and in all other Connection configuration scenarios, the Connection's own Connection Configuration Set supplies the transport connection parameters.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for DTLS/SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"endClientPort": {
"description": "The highest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2499. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ip": {
"description": "The IP address list for this Local Node. The IP addresses configured for a Local Node may include fixed IP addresses and/or IPFE Target Set Addresses. The list of valid IP addresses that can be assigned to a Local Node is provided in the /diameter/signalingipaddresses GET response.",
"items": {
"properties": {
"ipAddr": {
"description": "A single IP address configured for this Local Node.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipType": {
"description": "Each IP address is of type LocalIp or IpfeTsa. A Local IP is a fixed IP address assigned to a specific MP server within the DSR. An IPFE Target Set Address (TSA) is an IP address associated with a group of MP servers, which together are known as a Target Set.",
"enum": [
"LocalIp",
"IpfeTsa"
],
"type": "string"
}
},
"required": [
"ipAddr",
"ipType"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for this Local Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Local Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusClientPortEnabled": {
"description": "If set to true, this Local Node can send RADIUS request messages to a Peer Node (/diameter/peernodes), configured in the role of RADIUS server, using one of the UDP ports within the range defined by startClientPort and endClientPort.",
"type": "boolean"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port numbers used by RADIUS clients when sending RADIUS messages to this Local Node. Between zero and 10 (inclusive) UDP port numbers can be defined for a Local Node. If no UDP port numbers are supplied, this Local Node does not receive requests from RADIUS clients.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"startClientPort": {
"description": "The lowest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2000. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"tcpPort": {
"description": "TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TLS/TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"certVerifyMode",
"cexCfgSetName",
"connCfgSetName",
"fqdn",
"ip",
"name",
"radiusClientPortEnabled",
"realm"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "LocalNode1",
"ip": [
{
"ipAddr": "172.16.1.1",
"ipType" : "LocalIp"
}
],
"fqdn": "dp.domain.com",
"realm": "domain.com",
"configurationLevel": "46",
"connCfgSetName": "connCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"startClientPort": 5137,
"certType": "Tls",
"endClientPort": 19097,
"radiusClientPortEnabled": false,
"serverPort": [
42374,
23046
],
"certVerifyMode": "SslVerifyPeerVerifyClientOnce",
"certName": "certName1",
"dtlsPort": 4340
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/localnodes
Adds a new Local Node to the DSR configuration. The new Local Node must have a name that is unique to the SOAM's configuration. A single Local Node can be configured to support Diameter Connections (/diameter/connections), RADIUS Connections (/diameter/connections), or both.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/localnode/localnode.json",
"properties": {
"certName": {
"description": "A valid security certificate name.",
"maxLength": 255,
"type": "string"
},
"certType": {
"description": "The type of the security certificate identified by certName. DSR only supports certificate type Tls for assignment to a Local Node.",
"enum": [
"Tls"
],
"type": "string"
},
"certVerifyMode": {
"description": "The Certificate Verification Mode used when either a DTLS/SCTP or a TLS/TCP port is configured for this Local Node.",
"enum": [
"SslVerifyNone",
"SslVerifyPeer",
"SslVerifyPeerFailIfNoPeerCert",
"SslVerifyPeerVerifyClientOnce"
],
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/cexconfigurationsets) assigned to a Local Node supplies capabilities exchange parameters, which get applied to any Connection (/diameter/connections) that doesn't have its own CEX Configuration Set explicitly configured.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Local Node supplies default values for a variety of transport connection parameters. The only time a Local Node's Connection Configuration Set is used is when a responder-only Connection (/diameter/connections) is initially set up, awaiting establishment from a Peer Node (/diameter/peernodes). Once the responder-only Connection is established, and in all other Connection configuration scenarios, the Connection's own Connection Configuration Set supplies the transport connection parameters.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for DTLS/SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"endClientPort": {
"description": "The highest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2499. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ip": {
"description": "The IP address list for this Local Node. The IP addresses configured for a Local Node may include fixed IP addresses and/or IPFE Target Set Addresses. The list of valid IP addresses that can be assigned to a Local Node is provided in the /diameter/signalingipaddresses GET response.",
"items": {
"properties": {
"ipAddr": {
"description": "A single IP address configured for this Local Node.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipType": {
"description": "Each IP address is of type LocalIp or IpfeTsa. A Local IP is a fixed IP address assigned to a specific MP server within the DSR. An IPFE Target Set Address (TSA) is an IP address associated with a group of MP servers, which together are known as a Target Set.",
"enum": [
"LocalIp",
"IpfeTsa"
],
"type": "string"
}
},
"required": [
"ipAddr",
"ipType"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for this Local Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Local Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusClientPortEnabled": {
"description": "If set to true, this Local Node can send RADIUS request messages to a Peer Node (/diameter/peernodes), configured in the role of RADIUS server, using one of the UDP ports within the range defined by startClientPort and endClientPort.",
"type": "boolean"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port numbers used by RADIUS clients when sending RADIUS messages to this Local Node. Between zero and 10 (inclusive) UDP port numbers can be defined for a Local Node. If no UDP port numbers are supplied, this Local Node does not receive requests from RADIUS clients.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"startClientPort": {
"description": "The lowest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2000. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"tcpPort": {
"description": "TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TLS/TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"certVerifyMode",
"cexCfgSetName",
"connCfgSetName",
"fqdn",
"ip",
"name",
"radiusClientPortEnabled",
"realm"
],
"type": "object"
}
Example
{
"name": "LocalNode1",
"ip": [
{
"ipAddr": "172.16.1.1",
"ipType" : "LocalIp"
}
],
"fqdn": "dp.domain.com",
"realm": "domain.com",
"configurationLevel": "46",
"connCfgSetName": "connCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"startClientPort": 5137,
"certType": "Tls",
"endClientPort": 19097,
"radiusClientPortEnabled": false,
"serverPort": [
42374,
23046
],
"certVerifyMode": "SslVerifyPeerVerifyClientOnce",
"certName": "certName1",
"dtlsPort": 4340
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/localnodes/{name}
get /diameter/localnodes/{name}
Returns the configuration details for the specified Local Node. If the specified Local Node does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/localnodeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/localnode/localnode.json",
"properties": {
"certName": {
"description": "A valid security certificate name.",
"maxLength": 255,
"type": "string"
},
"certType": {
"description": "The type of the security certificate identified by certName. DSR only supports certificate type Tls for assignment to a Local Node.",
"enum": [
"Tls"
],
"type": "string"
},
"certVerifyMode": {
"description": "The Certificate Verification Mode used when either a DTLS/SCTP or a TLS/TCP port is configured for this Local Node.",
"enum": [
"SslVerifyNone",
"SslVerifyPeer",
"SslVerifyPeerFailIfNoPeerCert",
"SslVerifyPeerVerifyClientOnce"
],
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/cexconfigurationsets) assigned to a Local Node supplies capabilities exchange parameters, which get applied to any Connection (/diameter/connections) that doesn't have its own CEX Configuration Set explicitly configured.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Local Node supplies default values for a variety of transport connection parameters. The only time a Local Node's Connection Configuration Set is used is when a responder-only Connection (/diameter/connections) is initially set up, awaiting establishment from a Peer Node (/diameter/peernodes). Once the responder-only Connection is established, and in all other Connection configuration scenarios, the Connection's own Connection Configuration Set supplies the transport connection parameters.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for DTLS/SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"endClientPort": {
"description": "The highest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2499. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ip": {
"description": "The IP address list for this Local Node. The IP addresses configured for a Local Node may include fixed IP addresses and/or IPFE Target Set Addresses. The list of valid IP addresses that can be assigned to a Local Node is provided in the /diameter/signalingipaddresses GET response.",
"items": {
"properties": {
"ipAddr": {
"description": "A single IP address configured for this Local Node.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipType": {
"description": "Each IP address is of type LocalIp or IpfeTsa. A Local IP is a fixed IP address assigned to a specific MP server within the DSR. An IPFE Target Set Address (TSA) is an IP address associated with a group of MP servers, which together are known as a Target Set.",
"enum": [
"LocalIp",
"IpfeTsa"
],
"type": "string"
}
},
"required": [
"ipAddr",
"ipType"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for this Local Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Local Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusClientPortEnabled": {
"description": "If set to true, this Local Node can send RADIUS request messages to a Peer Node (/diameter/peernodes), configured in the role of RADIUS server, using one of the UDP ports within the range defined by startClientPort and endClientPort.",
"type": "boolean"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port numbers used by RADIUS clients when sending RADIUS messages to this Local Node. Between zero and 10 (inclusive) UDP port numbers can be defined for a Local Node. If no UDP port numbers are supplied, this Local Node does not receive requests from RADIUS clients.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"startClientPort": {
"description": "The lowest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2000. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"tcpPort": {
"description": "TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TLS/TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"certVerifyMode",
"cexCfgSetName",
"connCfgSetName",
"fqdn",
"ip",
"name",
"radiusClientPortEnabled",
"realm"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "LocalNode1",
"ip": [
{
"ipAddr": "172.16.1.1",
"ipType" : "LocalIp"
}
],
"fqdn": "dp.domain.com",
"realm": "domain.com",
"configurationLevel": "46",
"connCfgSetName": "connCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"startClientPort": 5137,
"certType": "Tls",
"endClientPort": 19097,
"radiusClientPortEnabled": false,
"serverPort": [
42374,
23046
],
"certVerifyMode": "SslVerifyPeerVerifyClientOnce",
"certName": "certName1",
"dtlsPort": 4340
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/localnodes/{name}
Updates the configuration for the specified Local Node. If the provided Local Node data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/localnode/localnode.json",
"properties": {
"certName": {
"description": "A valid security certificate name.",
"maxLength": 255,
"type": "string"
},
"certType": {
"description": "The type of the security certificate identified by certName. DSR only supports certificate type Tls for assignment to a Local Node.",
"enum": [
"Tls"
],
"type": "string"
},
"certVerifyMode": {
"description": "The Certificate Verification Mode used when either a DTLS/SCTP or a TLS/TCP port is configured for this Local Node.",
"enum": [
"SslVerifyNone",
"SslVerifyPeer",
"SslVerifyPeerFailIfNoPeerCert",
"SslVerifyPeerVerifyClientOnce"
],
"type": "string"
},
"cexCfgSetName": {
"description": "The CEX Configuration Set (/diameter/cexconfigurationsets) assigned to a Local Node supplies capabilities exchange parameters, which get applied to any Connection (/diameter/connections) that doesn't have its own CEX Configuration Set explicitly configured.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/diameter/connectionconfigurationsets) assigned to a Local Node supplies default values for a variety of transport connection parameters. The only time a Local Node's Connection Configuration Set is used is when a responder-only Connection (/diameter/connections) is initially set up, awaiting establishment from a Peer Node (/diameter/peernodes). Once the responder-only Connection is established, and in all other Connection configuration scenarios, the Connection's own Connection Configuration Set supplies the transport connection parameters.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for DTLS/SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"endClientPort": {
"description": "The highest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2499. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ip": {
"description": "The IP address list for this Local Node. The IP addresses configured for a Local Node may include fixed IP addresses and/or IPFE Target Set Addresses. The list of valid IP addresses that can be assigned to a Local Node is provided in the /diameter/signalingipaddresses GET response.",
"items": {
"properties": {
"ipAddr": {
"description": "A single IP address configured for this Local Node.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipType": {
"description": "Each IP address is of type LocalIp or IpfeTsa. A Local IP is a fixed IP address assigned to a specific MP server within the DSR. An IPFE Target Set Address (TSA) is an IP address associated with a group of MP servers, which together are known as a Target Set.",
"enum": [
"LocalIp",
"IpfeTsa"
],
"type": "string"
}
},
"required": [
"ipAddr",
"ipType"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for this Local Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Local Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusClientPortEnabled": {
"description": "If set to true, this Local Node can send RADIUS request messages to a Peer Node (/diameter/peernodes), configured in the role of RADIUS server, using one of the UDP ports within the range defined by startClientPort and endClientPort.",
"type": "boolean"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for SCTP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port numbers used by RADIUS clients when sending RADIUS messages to this Local Node. Between zero and 10 (inclusive) UDP port numbers can be defined for a Local Node. If no UDP port numbers are supplied, this Local Node does not receive requests from RADIUS clients.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"startClientPort": {
"description": "The lowest UDP port number that can be used by the Local Node to send RADIUS request messages to a RADIUS server. Typical value is 2000. Port 5220 is Restricted Port and cannot be part of selected range.",
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"tcpPort": {
"description": "TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 3868.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Local Node. Omitting this property indicates the Local Node does not listen for TLS/TCP Connections from Peer Nodes (/diameter/peernodes). Typical value is 5658.",
"maximum": 16383,
"minimum": 1024,
"type": "integer"
}
},
"required": [
"certVerifyMode",
"cexCfgSetName",
"connCfgSetName",
"fqdn",
"ip",
"name",
"radiusClientPortEnabled",
"realm"
],
"type": "object"
}
Example
{
"name": "LocalNode1",
"ip": [
{
"ipAddr": "172.16.1.1",
"ipType" : "LocalIp"
}
],
"fqdn": "dp.domain.com",
"realm": "domain.com",
"configurationLevel": "46",
"connCfgSetName": "connCfgSet1",
"cexCfgSetName": "cexCfgSet1",
"startClientPort": 5137,
"certType": "Tls",
"endClientPort": 19097,
"radiusClientPortEnabled": false,
"serverPort": [
42374,
23046
],
"certVerifyMode": "SslVerifyPeerVerifyClientOnce",
"certName": "certName1",
"dtlsPort": 4340
}
delete /diameter/localnodes/{name}
Deletes the specified Local Node from the SOAM configuration. A Local Node will only be deleted if all delete validation checks pass. If the Local Node is part of the configuration of some other Managed Object, the Local Node cannot be deleted. For example, if the Local Node is associated with a Connection (/diameter/connections), that association must first be removed (either by editing the Connection and choosing a different Local Node, or deleting the Connection entirely). Then the Local Node can be deleted from the configuration. An attempt to delete a Local Node that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: MCCMNC Mapping
The MccMnc mapping provides the mapping between a Mobile country code and a Mobile network code for network identification.
All MccMnc mapping is done at the NOAM.
/diameter/mccmncmappings
get /diameter/mccmncmappings
Returns all MccMnc mapping configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those MccMnc mapping data meeting the request parameters are returned in the response.
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/mccmncmappingCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmncmapping/mccmncmapping.json",
"properties": {
"ccndc": {
"description": "Country Code (CC) plus National Destination Code (NDC) that is associated with the MCC+MNC+optional MSIN prefix digits.",
"pattern": "^[0-9]{0,15}$",
"type": "integer"
},
"country": {
"description": "Country Name corresponding to the MCC",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"description": {
"description": "Optional description/note.",
"maxLength": 255,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncMappingId": {
"description": "The natural identifier for the mcc mapping instance. It is a combination of mcc, mnc and prefix field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
},
"prefix": {
"description": "Optional MSIN prefix digits that form a MCC+MNC+MSIN prefix digits string. An empty MSIN prefix digits (0 digits) is used to map MCC+MNC to configuration data. If MSIN prefix digits are specified, it maps MCC+MNC+MSIN prefix digits to configuration data.",
"pattern": "^[0-9]{0,10}$",
"type": "integer"
},
"realm": {
"description": "Diameter Realm that is associated with the MCC+MNC+optional MSIN prefix digits. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes (-) and underscore (_). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"mcc",
"mnc"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"ccndc": 34,
"country": "Greece",
"description": "Test",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote",
"prefix": 5,
"realm": "realm.com"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/mccmncmappings
Adds a new MccMnc mapping to the DIAMETER configuration. The Mnc or MccMnc mapping combination shall not already exists in the NOAM's configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmncmapping/mccmncmapping.json",
"properties": {
"ccndc": {
"description": "Country Code (CC) plus National Destination Code (NDC) that is associated with the MCC+MNC+optional MSIN prefix digits.",
"pattern": "^[0-9]{0,15}$",
"type": "integer"
},
"country": {
"description": "Country Name corresponding to the MCC",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"description": {
"description": "Optional description/note.",
"maxLength": 255,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncMappingId": {
"description": "The natural identifier for the mcc mapping instance. It is a combination of mcc, mnc and prefix field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
},
"prefix": {
"description": "Optional MSIN prefix digits that form a MCC+MNC+MSIN prefix digits string. An empty MSIN prefix digits (0 digits) is used to map MCC+MNC to configuration data. If MSIN prefix digits are specified, it maps MCC+MNC+MSIN prefix digits to configuration data.",
"pattern": "^[0-9]{0,10}$",
"type": "integer"
},
"realm": {
"description": "Diameter Realm that is associated with the MCC+MNC+optional MSIN prefix digits. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes (-) and underscore (_). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"mcc",
"mnc"
],
"type": "object"
}
Example
{
"ccndc": 34,
"country": "Greece",
"description": "Test",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote",
"prefix": 5,
"realm": "realm.com"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/mccmncmappings/{MCC}
get /diameter/mccmncmappings/{MCC}
Returns the configuration details for the specified MccMnc mapping data. If the specified MccMnc mapping does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- MCC: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/mccmncmappingItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmncmapping/mccmncmapping.json",
"properties": {
"ccndc": {
"description": "Country Code (CC) plus National Destination Code (NDC) that is associated with the MCC+MNC+optional MSIN prefix digits.",
"pattern": "^[0-9]{0,15}$",
"type": "integer"
},
"country": {
"description": "Country Name corresponding to the MCC",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"description": {
"description": "Optional description/note.",
"maxLength": 255,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncMappingId": {
"description": "The natural identifier for the mcc mapping instance. It is a combination of mcc, mnc and prefix field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
},
"prefix": {
"description": "Optional MSIN prefix digits that form a MCC+MNC+MSIN prefix digits string. An empty MSIN prefix digits (0 digits) is used to map MCC+MNC to configuration data. If MSIN prefix digits are specified, it maps MCC+MNC+MSIN prefix digits to configuration data.",
"pattern": "^[0-9]{0,10}$",
"type": "integer"
},
"realm": {
"description": "Diameter Realm that is associated with the MCC+MNC+optional MSIN prefix digits. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes (-) and underscore (_). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"mcc",
"mnc"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ccndc": 34,
"country": "Greece",
"description": "Test",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote",
"prefix": 5,
"realm": "realm.com"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/mccmncmappings/{MCC}
Updates the configuration for the specified MccMnc mapping. If the provided MccMnc mapping data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- MCC: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmncmapping/mccmncmapping.json",
"properties": {
"ccndc": {
"description": "Country Code (CC) plus National Destination Code (NDC) that is associated with the MCC+MNC+optional MSIN prefix digits.",
"pattern": "^[0-9]{0,15}$",
"type": "integer"
},
"country": {
"description": "Country Name corresponding to the MCC",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"description": {
"description": "Optional description/note.",
"maxLength": 255,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncMappingId": {
"description": "The natural identifier for the mcc mapping instance. It is a combination of mcc, mnc and prefix field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
},
"prefix": {
"description": "Optional MSIN prefix digits that form a MCC+MNC+MSIN prefix digits string. An empty MSIN prefix digits (0 digits) is used to map MCC+MNC to configuration data. If MSIN prefix digits are specified, it maps MCC+MNC+MSIN prefix digits to configuration data.",
"pattern": "^[0-9]{0,10}$",
"type": "integer"
},
"realm": {
"description": "Diameter Realm that is associated with the MCC+MNC+optional MSIN prefix digits. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes (-) and underscore (_). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"mcc",
"mnc"
],
"type": "object"
}
Example
{
"ccndc": 34,
"country": "Greece",
"description": "Test",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote",
"prefix": 5,
"realm": "realm.com"
}
delete /diameter/mccmncmappings/{MCC}
Deletes the specified MccMnc mapped data from the NOAM configuration. A MccMnc mapped data will only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- MCC: required (string)
Diameter: MCCMNC
Allows user to access MccMnc table and its associated attributes.
All MccMnc is done at the NOAM.
/diameter/mccmncs
get /diameter/mccmncs
Returns all MccMnc Table configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those MccMnc Tables meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/mccmncCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmnc/mccmnc.json",
"properties": {
"country": {
"description": "Country Name corresponding to the MCC.",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code.",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncId": {
"description": "The natural identifier for the mcc mnc instance. It is combination of mcc and mnc field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code.",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC.",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
}
},
"required": [
"country",
"mcc",
"mnc",
"networkname"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"country": "Greece",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/mccmncs
Adds a new MccMnc Table to the Diameter configuration. The new MccMnc Table must have a Mnc that is unique to the NOAM's configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmnc/mccmnc.json",
"properties": {
"country": {
"description": "Country Name corresponding to the MCC.",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code.",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncId": {
"description": "The natural identifier for the mcc mnc instance. It is combination of mcc and mnc field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code.",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC.",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
}
},
"required": [
"country",
"mcc",
"mnc",
"networkname"
],
"type": "object"
}
Example
{
"country": "Greece",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/mccmncs/{name}
get /diameter/mccmncs/{name}
Returns the configuration details for the specified MccMnc combination. If the specified MccMnc does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/mccmncItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmnc/mccmnc.json",
"properties": {
"country": {
"description": "Country Name corresponding to the MCC.",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code.",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncId": {
"description": "The natural identifier for the mcc mnc instance. It is combination of mcc and mnc field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code.",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC.",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
}
},
"required": [
"country",
"mcc",
"mnc",
"networkname"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"country": "Greece",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/mccmncs/{name}
Updates the configuration for the specified MccMnc combination. If the provided MccMnc data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mccmnc/mccmnc.json",
"properties": {
"country": {
"description": "Country Name corresponding to the MCC.",
"maxLength": 128,
"pattern": "^[ -~]+$",
"type": "string"
},
"mcc": {
"description": "Mobile Country Code.",
"maxLength": 3,
"pattern": "^[0-9]{3}$",
"type": "string"
},
"mccMncId": {
"description": "The natural identifier for the mcc mnc instance. It is combination of mcc and mnc field values.",
"readOnly": true,
"type": "string"
},
"mnc": {
"description": "Mobile Network Code.",
"maxLength": 3,
"pattern": "^[0-9]{2,3}$",
"type": "string"
},
"networkname": {
"description": "Network Name corresponding to the MNC.",
"maxLength": 128,
"pattern": "[ -~]+$",
"type": "string"
}
},
"required": [
"country",
"mcc",
"mnc",
"networkname"
],
"type": "object"
}
Example
{
"country": "Greece",
"mcc": "202",
"mnc": "01",
"networkname": "Cosmote"
}
delete /diameter/mccmncs/{name}
Deletes the specified MccMnc combination from the NOAM configuration. A MccMnc data will only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Message Copy Configuration Sets
Message Copy Configuration Sets provide a mechanism for determining which Diameter messages are copied and forwarded to a Diameter Application Server (DAS). The configuration set can be configured to copy request messages and, optionally, associated answer messages; the result-code/experimental result code on which the message copy is initiated; and the number of retries (up to four) to make if the message copy attempt to the Diameter Application Server fails.
The Message Copy Configuration Set named Default is always available. The Default Message Copy Configuration Set can be modified, but it cannot be deleted.
All Message Copy Configuration Set configuration is done at the SOAM.
/diameter/messagecopyconfigurationsets
get /diameter/messagecopyconfigurationsets
Returns all Message Copy Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Message Copy Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/messagecopyconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagecopyconfigurationset/messagecopyconfigurationset.json",
"properties": {
"answerIncluded": {
"description": "If true, and if this rule matches a request, the ingress answer message received in response to a Diameter message is also copied to the Diameter Application Server. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dasAnswerResultCode": {
"description": "The egress message code that should match with the ingress answer message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"maxRetryAttempts": {
"description": "The maximum number of retransmission attempts for a Diameter Application Server request. A value of zero indicates there are no retransmission attempts after the first copy attempt. No more than four attempts can be made. Typical value is 0.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Message Copy Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"originalAnswerResultCode": {
"description": "The ingress answer message code that should match with the egress message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"requestType": {
"description": "The type of request to copy can be either ingress or egress. Typical value is Ingress.",
"enum": [
"Egress",
"Ingress"
],
"type": "string"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this rule. A valid routeListName is required to copy a message to a Diameter Application Server.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"answerIncluded",
"dasAnswerResultCode",
"maxRetryAttempts",
"name",
"originalAnswerResultCode",
"requestType"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"answerIncluded": false,
"configurationLevel": "0",
"dasAnswerResultCode": "2xxx",
"maxRetryAttempts": 1,
"name": "MessageCopyConfigurationSet1",
"originalAnswer": "2xxx",
"requestType": "Ingress",
"routeListName": "RL6201"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/messagecopyconfigurationsets
Adds a new Message Copy Configuration Set to the DSR configuration. The Message Copy Configuration Set must have a name that is unique across all Message Copy Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagecopyconfigurationset/messagecopyconfigurationset.json",
"properties": {
"answerIncluded": {
"description": "If true, and if this rule matches a request, the ingress answer message received in response to a Diameter message is also copied to the Diameter Application Server. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dasAnswerResultCode": {
"description": "The egress message code that should match with the ingress answer message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"maxRetryAttempts": {
"description": "The maximum number of retransmission attempts for a Diameter Application Server request. A value of zero indicates there are no retransmission attempts after the first copy attempt. No more than four attempts can be made. Typical value is 0.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Message Copy Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"originalAnswerResultCode": {
"description": "The ingress answer message code that should match with the egress message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"requestType": {
"description": "The type of request to copy can be either ingress or egress. Typical value is Ingress.",
"enum": [
"Egress",
"Ingress"
],
"type": "string"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this rule. A valid routeListName is required to copy a message to a Diameter Application Server.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"answerIncluded",
"dasAnswerResultCode",
"maxRetryAttempts",
"name",
"originalAnswerResultCode",
"requestType"
],
"type": "object"
}
Example
{
"answerIncluded": false,
"configurationLevel": "0",
"dasAnswerResultCode": "2xxx",
"maxRetryAttempts": 1,
"name": "MessageCopyConfigurationSet1",
"originalAnswer": "2xxx",
"requestType": "Ingress",
"routeListName": "RL6201"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/messagecopyconfigurationsets/{name}
get /diameter/messagecopyconfigurationsets/{name}
Returns the configuration details for the specified Message Copy Configuration Set. If the Message Copy Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/messagecopyconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagecopyconfigurationset/messagecopyconfigurationset.json",
"properties": {
"answerIncluded": {
"description": "If true, and if this rule matches a request, the ingress answer message received in response to a Diameter message is also copied to the Diameter Application Server. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dasAnswerResultCode": {
"description": "The egress message code that should match with the ingress answer message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"maxRetryAttempts": {
"description": "The maximum number of retransmission attempts for a Diameter Application Server request. A value of zero indicates there are no retransmission attempts after the first copy attempt. No more than four attempts can be made. Typical value is 0.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Message Copy Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"originalAnswerResultCode": {
"description": "The ingress answer message code that should match with the egress message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"requestType": {
"description": "The type of request to copy can be either ingress or egress. Typical value is Ingress.",
"enum": [
"Egress",
"Ingress"
],
"type": "string"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this rule. A valid routeListName is required to copy a message to a Diameter Application Server.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"answerIncluded",
"dasAnswerResultCode",
"maxRetryAttempts",
"name",
"originalAnswerResultCode",
"requestType"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"answerIncluded": false,
"configurationLevel": "0",
"dasAnswerResultCode": "2xxx",
"maxRetryAttempts": 1,
"name": "MessageCopyConfigurationSet1",
"originalAnswer": "2xxx",
"requestType": "Ingress",
"routeListName": "RL6201"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/messagecopyconfigurationsets/{name}
Updates the configuration of the specified Message Copy Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagecopyconfigurationset/messagecopyconfigurationset.json",
"properties": {
"answerIncluded": {
"description": "If true, and if this rule matches a request, the ingress answer message received in response to a Diameter message is also copied to the Diameter Application Server. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dasAnswerResultCode": {
"description": "The egress message code that should match with the ingress answer message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"maxRetryAttempts": {
"description": "The maximum number of retransmission attempts for a Diameter Application Server request. A value of zero indicates there are no retransmission attempts after the first copy attempt. No more than four attempts can be made. Typical value is 0.",
"maximum": 4,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Message Copy Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"originalAnswerResultCode": {
"description": "The ingress answer message code that should match with the egress message copied to the server. Typical value is 2xxx.",
"enum": [
"2xxx",
"Any"
],
"type": "string"
},
"requestType": {
"description": "The type of request to copy can be either ingress or egress. Typical value is Ingress.",
"enum": [
"Egress",
"Ingress"
],
"type": "string"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this rule. A valid routeListName is required to copy a message to a Diameter Application Server.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"answerIncluded",
"dasAnswerResultCode",
"maxRetryAttempts",
"name",
"originalAnswerResultCode",
"requestType"
],
"type": "object"
}
Example
{
"answerIncluded": false,
"configurationLevel": "0",
"dasAnswerResultCode": "2xxx",
"maxRetryAttempts": 1,
"name": "MessageCopyConfigurationSet1",
"originalAnswer": "2xxx",
"requestType": "Ingress",
"routeListName": "RL6201"
}
delete /diameter/messagecopyconfigurationsets/{name}
Deletes the specified Message Copy Configuration Set from the SOAM configuration. The Default Message Copy Configuration Set cannot be deleted. A Message Copy Configuration Set can only be deleted if all delete validation checks pass. In general, if the Message Copy Configuration Set is a part of some other Managed Object, the Message Copy Configuration Set cannot be deleted. For example, if the Message Copy Configuration Set is named by a Peer Route Rule (/diameter/peerrouterules), the Message Copy Configuration Set must first be removed from Peer Route Rule. Then the Message Copy Configuration Set can be deleted from the configuration. An attempt to delete a Message Copy Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Message Priority Configuration Sets
A Message Priority Configuration Set provides a way to control how message priority is set for a request message arriving on a Diameter Connection (/diameter/connections). A Message Priority Configuration Set contains one or more Message Priority Rules.
A Message Priority Rule consists of an Application Id (/diameter/applicationids), Command Code (/diameter/commandcodes), and a priority. Ingress messages matching the Application Id and Command Code are assigned the associated priority.
The Message Priority Configuration Set named Default is always available; it can be modified, but it cannot be deleted.
All configuration of Message Priority Configuration Sets is done at the SOAM.
/diameter/messagepriorityconfigurationsets
get /diameter/messagepriorityconfigurationsets
Returns all Message Priority Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Message Priority Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/messagepriorityconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagepriorityconfigurationset/messagepriorityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"messagePriorityRule": {
"description": "The rules associated with this Message Priority Configuration Set. Each rule is defined by appId, cmdCode, and msgPriority.",
"items": {
"properties": {
"appId": {
"description": "appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Message Priority Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId and cmdCode values in this rule according to the priority configured in the rule. The value must be an integer in the range 0-4294967295. To include all Application Ids in this rule, set ruleAppliesToAllAppIds to true, and the value for appId is ignored.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match. The Command Code is an integer (represented as a string), while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. To include all Command Codes in this rule, supply the string 'All'.",
"maxLength": 30,
"type": "string"
},
"priority": {
"description": "The priority given to an ingress Diameter message where the Application Id (/diameter/applicationids) and Command Code (/diameter/commandcodes) match the appId and cmdCode values, respectively. The value assigned to priority cannot exceed the ngnPsMaxNormalRequestPriority value (/diameter/options).",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"ruleAppliesToAllAppIds": {
"description": "When set to true, this Message Priority Rule applies to all Application Ids (/diameter/applicationids), and DSR ignores the specific appId value for this rule.",
"type": "boolean"
}
},
"required": [
"cmdCode",
"priority",
"ruleAppliesToAllAppIds"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for the Message Priority Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"messagePriorityRule"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "55555",
"messagePriorityRule": [
{
"appId": 4294967295,
"cmdCode": "258",
"priority": 0,
"ruleAppliesToAllAppIds": false
}, {
"appId": 4,
"cmdCode": "258.258.0",
"priority": 1,
"ruleAppliesToAllAppIds": false
}, {
"appId": 16777216,
"cmdCode": "8388655",
"priority": 2,
"ruleAppliesToAllAppIds": false
}, {
"cmdCode": "All",
"priority": 1,
"ruleAppliesToAllAppIds": true
}
],
"name": "MessagePriorityConfigurationSet1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/messagepriorityconfigurationsets
Adds a new Message Priority Configuration Set to the DSR configuration. The new Message Priority Configuration Set name must be unique across all Message Priority Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagepriorityconfigurationset/messagepriorityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"messagePriorityRule": {
"description": "The rules associated with this Message Priority Configuration Set. Each rule is defined by appId, cmdCode, and msgPriority.",
"items": {
"properties": {
"appId": {
"description": "appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Message Priority Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId and cmdCode values in this rule according to the priority configured in the rule. The value must be an integer in the range 0-4294967295. To include all Application Ids in this rule, set ruleAppliesToAllAppIds to true, and the value for appId is ignored.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match. The Command Code is an integer (represented as a string), while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. To include all Command Codes in this rule, supply the string 'All'.",
"maxLength": 30,
"type": "string"
},
"priority": {
"description": "The priority given to an ingress Diameter message where the Application Id (/diameter/applicationids) and Command Code (/diameter/commandcodes) match the appId and cmdCode values, respectively. The value assigned to priority cannot exceed the ngnPsMaxNormalRequestPriority value (/diameter/options).",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"ruleAppliesToAllAppIds": {
"description": "When set to true, this Message Priority Rule applies to all Application Ids (/diameter/applicationids), and DSR ignores the specific appId value for this rule.",
"type": "boolean"
}
},
"required": [
"cmdCode",
"priority",
"ruleAppliesToAllAppIds"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for the Message Priority Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"messagePriorityRule"
],
"type": "object"
}
Example
{
"configurationLevel": "55555",
"messagePriorityRule": [
{
"appId": 4294967295,
"cmdCode": "258",
"priority": 0,
"ruleAppliesToAllAppIds": false
}, {
"appId": 4,
"cmdCode": "258.258.0",
"priority": 1,
"ruleAppliesToAllAppIds": false
}, {
"appId": 16777216,
"cmdCode": "8388655",
"priority": 2,
"ruleAppliesToAllAppIds": false
}, {
"cmdCode": "All",
"priority": 1,
"ruleAppliesToAllAppIds": true
}
],
"name": "MessagePriorityConfigurationSet1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/messagepriorityconfigurationsets/{name}
get /diameter/messagepriorityconfigurationsets/{name}
Returns the configuration details for the specified Message Priority Configuration Set. If the Message Priority Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/messagepriorityconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagepriorityconfigurationset/messagepriorityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"messagePriorityRule": {
"description": "The rules associated with this Message Priority Configuration Set. Each rule is defined by appId, cmdCode, and msgPriority.",
"items": {
"properties": {
"appId": {
"description": "appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Message Priority Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId and cmdCode values in this rule according to the priority configured in the rule. The value must be an integer in the range 0-4294967295. To include all Application Ids in this rule, set ruleAppliesToAllAppIds to true, and the value for appId is ignored.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match. The Command Code is an integer (represented as a string), while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. To include all Command Codes in this rule, supply the string 'All'.",
"maxLength": 30,
"type": "string"
},
"priority": {
"description": "The priority given to an ingress Diameter message where the Application Id (/diameter/applicationids) and Command Code (/diameter/commandcodes) match the appId and cmdCode values, respectively. The value assigned to priority cannot exceed the ngnPsMaxNormalRequestPriority value (/diameter/options).",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"ruleAppliesToAllAppIds": {
"description": "When set to true, this Message Priority Rule applies to all Application Ids (/diameter/applicationids), and DSR ignores the specific appId value for this rule.",
"type": "boolean"
}
},
"required": [
"cmdCode",
"priority",
"ruleAppliesToAllAppIds"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for the Message Priority Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"messagePriorityRule"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "55555",
"messagePriorityRule": [
{
"appId": 4294967295,
"cmdCode": "258",
"priority": 0,
"ruleAppliesToAllAppIds": false
}, {
"appId": 4,
"cmdCode": "258.258.0",
"priority": 1,
"ruleAppliesToAllAppIds": false
}, {
"appId": 16777216,
"cmdCode": "8388655",
"priority": 2,
"ruleAppliesToAllAppIds": false
}, {
"cmdCode": "All",
"priority": 1,
"ruleAppliesToAllAppIds": true
}
],
"name": "MessagePriorityConfigurationSet1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/messagepriorityconfigurationsets/{name}
Updates the configuration of the specified Message Priority Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/messagepriorityconfigurationset/messagepriorityconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"messagePriorityRule": {
"description": "The rules associated with this Message Priority Configuration Set. Each rule is defined by appId, cmdCode, and msgPriority.",
"items": {
"properties": {
"appId": {
"description": "appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Message Priority Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId and cmdCode values in this rule according to the priority configured in the rule. The value must be an integer in the range 0-4294967295. To include all Application Ids in this rule, set ruleAppliesToAllAppIds to true, and the value for appId is ignored.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match. The Command Code is an integer (represented as a string), while Extended Command Codes are of the format X.Y.Z, where X is a Command Code; Y and Z are 32-bit unassigned integers; and the dots are literal. To include all Command Codes in this rule, supply the string 'All'.",
"maxLength": 30,
"type": "string"
},
"priority": {
"description": "The priority given to an ingress Diameter message where the Application Id (/diameter/applicationids) and Command Code (/diameter/commandcodes) match the appId and cmdCode values, respectively. The value assigned to priority cannot exceed the ngnPsMaxNormalRequestPriority value (/diameter/options).",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"ruleAppliesToAllAppIds": {
"description": "When set to true, this Message Priority Rule applies to all Application Ids (/diameter/applicationids), and DSR ignores the specific appId value for this rule.",
"type": "boolean"
}
},
"required": [
"cmdCode",
"priority",
"ruleAppliesToAllAppIds"
],
"type": "object"
},
"maxItems": 50,
"minItems": 1,
"type": "array"
},
"name": {
"description": "Name for the Message Priority Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"messagePriorityRule"
],
"type": "object"
}
Example
{
"configurationLevel": "55555",
"messagePriorityRule": [
{
"appId": 4294967295,
"cmdCode": "258",
"priority": 0,
"ruleAppliesToAllAppIds": false
}, {
"appId": 4,
"cmdCode": "258.258.0",
"priority": 1,
"ruleAppliesToAllAppIds": false
}, {
"appId": 16777216,
"cmdCode": "8388655",
"priority": 2,
"ruleAppliesToAllAppIds": false
}, {
"cmdCode": "All",
"priority": 1,
"ruleAppliesToAllAppIds": true
}
],
"name": "MessagePriorityConfigurationSet1"
}
delete /diameter/messagepriorityconfigurationsets/{name}
Deletes the specified Message Priority Configuration Set from the SOAM configuration. The Default Message Priority Configuration Set cannot be deleted. A Message Priority Configuration Set can only be deleted if all delete validation checks pass. In general, if the Message Priority Configuration Set is part of the configuration of one or more Connections (/diameter/connections) or Peer Nodes (/diameter/peernodes), the Message Priority Configuration Set cannot be deleted. If the Message Priority Configuration Set is named in a Connection or Peer Node, the Message Priority Configuration Set must first be removed from the Connection or Peer Node. Then the Message Priority Configuration Set can be deleted from the configuration. An attempt to delete a Message Priority Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Set: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: MPs Profiles
MPs Profiles DA-MP Elements describes the fields of DA-MP. The Data Input Notes apply only to the DA-MP Configurable elements.
MPs Profiles SS7-MP Elements describes the view-only fields of SS7-MP in Diameter Common.
/diameter/mpprofile
get /diameter/mpprofile
Returns all DA-MP and SS7-MP Elements of MPs Profiles at the SOAM which meet the criteria specified in a valid GET request.
Target server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/mpprofileCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mpprofile/mpprofile.json",
"properties": {
"DAMPElements": {
"description": "Describes the fields on the DA-MP of MP Profile. The Data Input Notes apply only to the DA-MP Configurable elements.",
"items": {
"properties": {
"profileName": {
"description": "These are profile parameters of Mp profile.",
"enum": [
"G6_Relay",
"G8G9_Relay",
"G7_Relay",
"G6_Database",
"G8G9_Database",
"G7_Database",
"G6_Session",
"G8G9_Session",
"G7_Session",
"G6_Session_Database",
"G8G9_Session_Database",
"G7_Session_Database",
"VM_Relay",
"VM_Database",
"UDRVM_Database",
"VM_6K_MPS",
"VM_8K_MPS",
"VM_10K_MPS",
"VM_12K_MPS",
"VM_14K_MPS",
"VM_16K_MPS",
"VM_18K_MPS",
"VM_21K_MPS",
"VM_24K_MPS",
"VM_27K_MPS",
"VM_30K_MPS",
"G8G9_MDIWF",
"VM_MDIWF",
"Gen9V2_Relay",
"Gen9V2_Database",
"Gen9V2_Session"
],
"items": {
"properties": {
"AvgHoldTimeCriticalClear": {
"description": "The Average Hold Time above which a critical alarm is cleared.",
"type": "integer"
},
"AvgHoldTimeCriticalSet": {
"description": "The Average Hold Time above which a critical alarm is set.",
"type": "integer"
},
"AvgHoldTimeMajorClear": {
"description": "The Average Hold Time above which a major alarm is cleared.",
"type": "integer"
},
"AvgHoldTimeMajorSet": {
"description": "The Average Hold Time above which a major alarm is set.",
"type": "integer"
},
"AvgHoldTimeMinorClear": {
"description": "The Average Hold Time above which a minor alarm is cleared.",
"type": "integer"
},
"AvgHoldTimeMinorSet": {
"description": "The Average Hold Time above which a minor alarm is set.",
"type": "integer"
},
"CL1DiscardPercent": {
"description": "The percentage below DA-MP Engineered Ingress MPS that DA-MP Overload Control will police the total DA-MP ingress MPS when the DA-MP is in congestion level 1.",
"maximum": 50,
"minimum": 0,
"default": 0,
"type": "integer"
},
"CL2DiscardPercent": {
"description": "The percentage below DA-MP Engineered Ingress MPS that DA-MP Overload Control will police the total DA-MP ingress MPS when the DA-MP is in congestion level 2.",
"maximum": 50,
"minimum": 10,
"default": 20,
"type": "integer"
},
"CL3DiscardPercent": {
"description": "The percentage below DA-MP Engineered Ingress MPS that DA-MP Overload Control will police the total DA-MP ingress MPS when the DA-MP is in congestion level 3.",
"maximum": 50,
"minimum": 20,
"default": 40,
"type": "integer"
},
"ConvergenceTime": {
"description": "Time (in ms). The time it will take in milliseconds to converge on a per second rate. If the convergence time is less than 1000 milliseconds, the rate is extrapolated. If the convergence time is greater than 1000 milliseconds, the rate is averaged.",
"enum": [
"250",
"500",
"1000",
"2000",
"4000"
],
"default": 1000,
"type": "integer"
},
"CpaAnswerTaskThr": {
"description": "The number of CPA Application threads created in the Diameter Stack to process Answer messages from the CPA Answer Message Queue.'",
"type": "integer"
},
"CpaEventTaskThr": {
"description": "The number of CPA Application threads created in the Diameter Stack to process Event messages from the CPA Event Message Queue.",
"type": "integer"
},
"CpaRequestTaskThr": {
"description": "The number of CPA Application threads created in the Diameter Stack to process Request messages from the CPA Request Message Queue.",
"type": "integer"
},
"DclEventTaskThr": {
"description": "The number of threads created in the Diameter Stack to process Diameter messages and status messages transmitted from the Diameter Routing Layer to the Diameter Connection Layer.",
"type": "integer"
},
"DOCMsgDiscardPercent": {
"description": "The percent of total DA-MP ingress MPS above DA-MP Engineered Ingress MPS that DA-MP Overload Control will discard when the DA-MP is in danger of congestion.",
"maximum": 50,
"minimum": 0,
"default": 20,
"type": "integer"
},
"DrlAnswerTaskThr": {
"description": "The number of answer threads created in the Diameter Stack to process Answer messages from the Answer Message Queue.",
"type": "integer"
},
"DrlMsgCopyTaskThr": {
"description": "The number of threads used by the Message Copy task to process Diameter messages.",
"type": "integer"
},
"DrlRequestTaskThr": {
"description": "The number of request threads created in the Diameter Stack to process Request messages from the Request Message Queue.",
"type": "integer"
},
"DrlRerouteTaskThr": {
"description": "The number of reroute threads created in the Diameter Stack to process Request messages from the Reroute Message Queue.",
"type": "integer"
},
"FabrDpRspTaskThr": {
"description": "The number of FABR Application threads created in the Diameter Stack to process data responses from the DP (Data Processor) Response Message Queue.",
"type": "integer"
},
"FabrDpStatusTaskThr": {
"description": "The number of FABR Application threads created in the Diameter Stack to process status notifications from the DP (Data Processor) Servers.",
"type": "integer"
},
"FabrReqTaskThr": {
"description": "The number of FABR Application threads created in the Diameter Stack to process Request messages from the RBAR Request Message Queue.",
"type": "integer"
},
"GlaRxMsgRate": {
"description": "The ingress request rate for the GLA Application.",
"type": "integer"
},
"HeapParam.dsr": {
"description": "Heap size for the DSR process that runs the Diameter Stack.",
"type": "integer"
},
"LongTimeoutPtrList": {
"description": "A Long Pending Transaction Record (Long PTR) buffer is allocated for each request message that arrives at an MP using a Pending Answer Timer above 10 seconds and is de-allocated when the corresponding answer message is sent back. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"MaxConnsThisMp": {
"description": "The maximum number of Diameter connections the DA-MP can have configured at any one time.",
"maximum": 50,
"minimum": 0,
"default": 20,
"type": "integer"
},
"MaxPendingTransactions": {
"description": "The maximum number of outstanding Requests the DA-MP can have at one time. Each Request routed to a peer is considered one pending transaction.",
"type": "integer"
},
"MpEngIngressMps": {
"description": "The maximum ingress message rate that a DA-MP will support without overload. This value provides a limit to the total Reserved Ingress MPS of all Diameter Connections assigned to the DA-MP.",
"type": "integer"
},
"MpMaxIngressMps": {
"description": "The maximum ingress message rate that will be delivered to the Diameter Routing Layer from the Diameter Connection Layer on an DA-MP. Messages received above this rate are automatically discarded by the Diameter Connection Layer.",
"type": "integer"
},
"MpRxAllRateCriticalClear": {
"description": "The ingress message rate below which a critical alarm is cleared.",
"type": "integer"
},
"MpRxAllRateCriticalSet": {
"description": "The ingress message rate below which a critical alarm is raised.",
"type": "integer"
},
"MpRxAllRateMajorClear": {
"description": "The ingress message rate below which a major alarm is cleared.",
"type": "integer"
},
"MpRxAllRateMajorSet": {
"description": "The ingress message rate below which a major alarm is raised",
"type": "integer"
},
"MpRxAllRateMinorClear": {
"description": "The ingress message rate below which a minor alarm is cleared.",
"type": "integer"
},
"MpRxAllRateMinorSet": {
"description": "The ingress message rate below which a minor alarm is raised",
"type": "integer"
},
"MpRxDiamAllLenCriticalClear": {
"description": "The Average Message Size above which a critical alarm is cleared.",
"type": "integer"
},
"MpRxDiamAllLenCriticalSet": {
"description": "The Average Message Size above which a critical alarm is set.",
"type": "integer"
},
"MpRxDiamAllLenMajorClear": {
"description": "The Average Message Size above which a major alarm is cleared.",
"type": "integer"
},
"MpRxDiamAllLenMajorSet": {
"description": "The Average Message Size above which a major alarm is raised.",
"type": "integer"
},
"MpRxDiamAllLenMinorClear": {
"description": "The Average Message Size above which a minor alarm is cleared.",
"type": "integer"
},
"MpRxDiamAllLenMinorSet": {
"description": "The Average Message Size above which a minor alarm is raised.",
"type": "integer"
},
"OtherMask": {
"description": "The CPU affinity mask that assigns StackTimer and DbChangeAgent threads to specific internal cores in the DA-MP.",
"type": "integer"
},
"PdraAnswerTaskThr": {
"description": "The number of answer task threads created in the P-DRA to process the Answer messages from the P-DRA Answer Message Queue.",
"type": "integer"
},
"PdraRequestTaskThr": {
"description": "The number of request task threads created in the P-DRA to process the Request messages from the P-DRA Request Message Queue.",
"type": "integer"
},
"PdraSbrEventTaskThr": {
"description": "The number of P-DRA SBR Event Task threads created in the P-DRA to process SBR Event messages from the P-DRA SBR Event Message Queue.",
"type": "integer"
},
"RbarApplTaskThr": {
"description": "The number of RBAR Application threads created in the Diameter Stack to process Request messages from the RBAR Request Message Queue.",
"type": "integer"
},
"RoutingMsgRateCriticalClear": {
"description": "The Diameter Routing Layer message processing rate below which a critical alarm is cleared.",
"type": "integer"
},
"RoutingMsgRateCriticalSet": {
"description": "The Diameter Routing Layer message processing rate below which a critical alarm is raised.",
"type": "integer"
},
"RoutingMsgRateMajorClear": {
"description": "The Diameter Routing Layer message processing rate below which a major alarm is cleared.",
"type": "integer"
},
"RoutingMsgRateMajorSet": {
"description": "The Diameter Routing Layer message processing rate below which a major alarm is raised",
"type": "integer"
},
"RoutingMsgRateMinorClear": {
"description": "The Diameter Routing Layer message processing rate below which a minor alarm is cleared",
"type": "integer"
},
"RoutingMsgRateMinorSet": {
"description": "The Diameter Routing Layer message processing rate below which a minor alarm is raised",
"type": "integer"
},
"RxBatchSize": {
"description": "The maximum number of ingress messages that can be received by the Diameter Connection Layer on a connection in a single receive thread read cycle.",
"type": "integer"
},
"RxCpaAnswerMsgQueue": {
"description": "The internal Answer message queue to the CPA Application within the Diameter Stack. This queue stores Answer messages as they arrive from Diameter Routing Layer to the CPA Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxCpaEventMsgQueue": {
"description": "The internal event message queue to the CPA Application within the Diameter Stack. This queue stores internal control messages as they arrive from Diameter Routing Layer to the CPA Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxCpaMsgRateCriticalClear": {
"description": "The ingress request rate for the CPA Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxCpaMsgRateCriticalSet": {
"description": "The ingress request rate for the CPA Application below which a critical alarm is raised",
"type": "integer"
},
"RxCpaMsgRateMajorClear": {
"description": "The ingress request rate for the CPA Application below which a major alarm is cleared.",
"type": "integer"
},
"RxCpaMsgRateMajorSet": {
"description": "The ingress request rate for the CPA Application below which a major alarm is raised.",
"type": "integer"
},
"RxCpaMsgRateMinorClear": {
"description": "The ingress request rate for the CPA Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxCpaMsgRateMinorSet": {
"description": "The ingress request rate for the CPA Application below which a minor alarm is raised.",
"type": "integer"
},
"RxCpaRequestMsgQueue": {
"description": "The internal Request message queue to the CPA Application within the Diameter Stack. This queue stores Request messages as they arrive from Diameter Routing Layer to the CPA Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxDmiwfMsgRateCriticalClear": {
"description": "The ingress request rate for the DM-IWF Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxDmiwfMsgRateCriticalSet": {
"description": "The ingress request rate for the DM-IWF Application below which a critical alarm is raised.",
"type": "integer"
},
"RxDmiwfMsgRateMajorClear": {
"description": "The ingress request rate for the DM-IWF Application below which a major alarm is cleared.",
"type": "integer"
},
"RxDmiwfMsgRateMajorSet": {
"description": "The ingress request rate for the DM-IWF Application below which a major alarm is raised.",
"type": "integer"
},
"RxDmiwfMsgRateMinorClear": {
"description": "The ingress request rate for the DM-IWF Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxDmiwfMsgRateMinorSet": {
"description": "The ingress request rate for the DM-IWF Application below which a minor alarm is raised.",
"type": "integer"
},
"RxFabrDpResponseMsgQueue": {
"description": "The internal DP message queue to the FABR Application within the Diameter Stack. This queue stores resposes as they arrive from DP to the FABR Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxFabrMsgRateCriticalClear": {
"description": "The ingress request rate for the FABR Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxFabrMsgRateCriticalSet": {
"description": "The ingress request rate for the FABR Application below which a critical alarm is raised.",
"type": "integer"
},
"RxFabrMsgRateMajorClear": {
"description": "The ingress request rate for the FABR Application below which a major alarm is cleared.",
"type": "integer"
},
"RxFabrMsgRateMajorSet": {
"description": "The ingress request rate for the FABR Application below which a major alarm is raised.",
"type": "integer"
},
"RxFabrMsgRateMinorClear": {
"description": "The ingress request rate for the FABR Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxFabrMsgRateMinorSet": {
"description": "The ingress request rate for the FABR Application below which a minor alarm is raised.",
"type": "integer"
},
"RxFabrRequestMsgQueue": {
"description": "The internal request message queue to the FABR Application within the Diameter Stack. This queue stores Request messages as they arrive from Diameter Routing Layer to the FABR Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxMsgRateMp": {
"description": "The ingress message rate measures the routable messages per second that the MP receives from the network. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxPdraAnswerMsgQueue": {
"description": "he maximum size of P-DRA Answer Message Queue.",
"type": "integer"
},
"RxPdraReqRate": {
"description": "This parameter is used to measure the average number of Diameter requests received by P-DRA from the DRL layer per second.",
"type": "integer"
},
"RxPdraRequestMsgQueue": {
"description": "The maximum size of the P-DRA Request Message Queue.",
"type": "integer"
},
"RxPdraSbrEventMsgQueue": {
"description": "The maximum size of P-DRA SBR Event Message Queue.",
"type": "integer"
},
"RxRbarMsgRateCriticalClear": {
"description": "The ingress request rate for the RBAR Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxRbarMsgRateCriticalSet": {
"description": "The ingress request rate for the RBAR Application below which a critical alarm is raised",
"type": "integer"
},
"RxRbarMsgRateMajorClear": {
"description": "The ingress request rate for the RBAR Application below which a major alarm is cleared",
"type": "integer"
},
"RxRbarMsgRateMajorSet": {
"description": "The ingress request rate for the RBAR Application below which a major alarm is raised",
"type": "integer"
},
"RxRbarMsgRateMinorClear": {
"description": "The ingress request rate for the RBAR Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxRbarMsgRateMinorSet": {
"description": "The ingress request rate for the RBAR Application below which a minor alarm is raised",
"type": "integer"
},
"RxRbarRequestMsgQueue": {
"description": "The internal request message queue to the RBAR Application within the Diameter Stack. This queue stores Request messages as they arrive from Diameter Routing Layer to the RBAR Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxThreadMask": {
"description": "The CPU affinity mask that assigns Receive threads to specific internal cores in the DA-MP.",
"type": "integer"
},
"RxThreadPool": {
"description": "The number of Diameter Connection Layer receive threads created to read Diameter messages from connections.",
"type": "integer"
},
"StackLayerMask": {
"description": "The CPU affinity mask that assigns Stack Tasks to specific internal cores in the DA-MP.",
"type": "integer"
},
"TxBatchSize": {
"description": "The maximum number of egress messages that can be transmitted by the Diameter Connection Layer on a connection in a single transmit thread write cycle.",
"type": "integer"
},
"TxThreadMask": {
"description": "The CPU affinity mask that assigns Transmit threads to specific internal cores in the DA-MP.",
"type": "integer"
},
"TxThreadPool": {
"description": "The number of Diameter Connection Layer transmit threads created to write Diameter messages to connections.",
"type": "integer"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
}
},
"required": [
"CL1DiscardPercent",
"CL2DiscardPercent",
"CL3DiscardPercent",
"ConvergenceTime",
"DOCMsgDiscardPercent"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"SS7MPElements": {
"description": "Describes the fields on the SS7-MP of MP Profile.",
"items": {
"properties": {
"profileName": {
"description": "These are profile parameters of Mp profile.",
"items": {
"properties": {
"RxMdIwfIngressMsgRateCriticalClear": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxMdIwfIngressMsgRateCriticalSet": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a critical alarm is raised.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMajorClear": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a major alarm is cleared.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMajorSet": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a major alarm is raised.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMinorClear": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMinorSet": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a minor alarm is raised.",
"type": "integer"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"G6_Relay": {
"CL1DiscardPercent" : 0,
"CL2DiscardPercent" : 20,
"CL3DiscardPercent" : 40,
"ConvergenceTime" : 1000,
"DOCMsgDiscardPercent" : 20
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/diameter/mpprofile/{name}
get /diameter/mpprofile/{name}
put /diameter/mpprofile/{name}
Updates the configuration for the specified MP profile. If the provided MP profile data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mpprofile/mpprofile.json",
"properties": {
"DAMPElements": {
"description": "Describes the fields on the DA-MP of MP Profile. The Data Input Notes apply only to the DA-MP Configurable elements.",
"items": {
"properties": {
"profileName": {
"description": "These are profile parameters of Mp profile.",
"enum": [
"G6_Relay",
"G8G9_Relay",
"G7_Relay",
"G6_Database",
"G8G9_Database",
"G7_Database",
"G6_Session",
"G8G9_Session",
"G7_Session",
"G6_Session_Database",
"G8G9_Session_Database",
"G7_Session_Database",
"VM_Relay",
"VM_Database",
"UDRVM_Database",
"VM_6K_MPS",
"VM_8K_MPS",
"VM_10K_MPS",
"VM_12K_MPS",
"VM_14K_MPS",
"VM_16K_MPS",
"VM_18K_MPS",
"VM_21K_MPS",
"VM_24K_MPS",
"VM_27K_MPS",
"VM_30K_MPS",
"G8G9_MDIWF",
"VM_MDIWF",
"Gen9V2_Relay",
"Gen9V2_Database",
"Gen9V2_Session"
],
"items": {
"properties": {
"AvgHoldTimeCriticalClear": {
"description": "The Average Hold Time above which a critical alarm is cleared.",
"type": "integer"
},
"AvgHoldTimeCriticalSet": {
"description": "The Average Hold Time above which a critical alarm is set.",
"type": "integer"
},
"AvgHoldTimeMajorClear": {
"description": "The Average Hold Time above which a major alarm is cleared.",
"type": "integer"
},
"AvgHoldTimeMajorSet": {
"description": "The Average Hold Time above which a major alarm is set.",
"type": "integer"
},
"AvgHoldTimeMinorClear": {
"description": "The Average Hold Time above which a minor alarm is cleared.",
"type": "integer"
},
"AvgHoldTimeMinorSet": {
"description": "The Average Hold Time above which a minor alarm is set.",
"type": "integer"
},
"CL1DiscardPercent": {
"description": "The percentage below DA-MP Engineered Ingress MPS that DA-MP Overload Control will police the total DA-MP ingress MPS when the DA-MP is in congestion level 1.",
"maximum": 50,
"minimum": 0,
"default": 0,
"type": "integer"
},
"CL2DiscardPercent": {
"description": "The percentage below DA-MP Engineered Ingress MPS that DA-MP Overload Control will police the total DA-MP ingress MPS when the DA-MP is in congestion level 2.",
"maximum": 50,
"minimum": 10,
"default": 20,
"type": "integer"
},
"CL3DiscardPercent": {
"description": "The percentage below DA-MP Engineered Ingress MPS that DA-MP Overload Control will police the total DA-MP ingress MPS when the DA-MP is in congestion level 3.",
"maximum": 50,
"minimum": 20,
"default": 40,
"type": "integer"
},
"ConvergenceTime": {
"description": "Time (in ms). The time it will take in milliseconds to converge on a per second rate. If the convergence time is less than 1000 milliseconds, the rate is extrapolated. If the convergence time is greater than 1000 milliseconds, the rate is averaged.",
"enum": [
"250",
"500",
"1000",
"2000",
"4000"
],
"default": 1000,
"type": "integer"
},
"CpaAnswerTaskThr": {
"description": "The number of CPA Application threads created in the Diameter Stack to process Answer messages from the CPA Answer Message Queue.'",
"type": "integer"
},
"CpaEventTaskThr": {
"description": "The number of CPA Application threads created in the Diameter Stack to process Event messages from the CPA Event Message Queue.",
"type": "integer"
},
"CpaRequestTaskThr": {
"description": "The number of CPA Application threads created in the Diameter Stack to process Request messages from the CPA Request Message Queue.",
"type": "integer"
},
"DclEventTaskThr": {
"description": "The number of threads created in the Diameter Stack to process Diameter messages and status messages transmitted from the Diameter Routing Layer to the Diameter Connection Layer.",
"type": "integer"
},
"DOCMsgDiscardPercent": {
"description": "The percent of total DA-MP ingress MPS above DA-MP Engineered Ingress MPS that DA-MP Overload Control will discard when the DA-MP is in danger of congestion.",
"maximum": 50,
"minimum": 0,
"default": 20,
"type": "integer"
},
"DrlAnswerTaskThr": {
"description": "The number of answer threads created in the Diameter Stack to process Answer messages from the Answer Message Queue.",
"type": "integer"
},
"DrlMsgCopyTaskThr": {
"description": "The number of threads used by the Message Copy task to process Diameter messages.",
"type": "integer"
},
"DrlRequestTaskThr": {
"description": "The number of request threads created in the Diameter Stack to process Request messages from the Request Message Queue.",
"type": "integer"
},
"DrlRerouteTaskThr": {
"description": "The number of reroute threads created in the Diameter Stack to process Request messages from the Reroute Message Queue.",
"type": "integer"
},
"FabrDpRspTaskThr": {
"description": "The number of FABR Application threads created in the Diameter Stack to process data responses from the DP (Data Processor) Response Message Queue.",
"type": "integer"
},
"FabrDpStatusTaskThr": {
"description": "The number of FABR Application threads created in the Diameter Stack to process status notifications from the DP (Data Processor) Servers.",
"type": "integer"
},
"FabrReqTaskThr": {
"description": "The number of FABR Application threads created in the Diameter Stack to process Request messages from the RBAR Request Message Queue.",
"type": "integer"
},
"GlaRxMsgRate": {
"description": "The ingress request rate for the GLA Application.",
"type": "integer"
},
"HeapParam.dsr": {
"description": "Heap size for the DSR process that runs the Diameter Stack.",
"type": "integer"
},
"LongTimeoutPtrList": {
"description": "A Long Pending Transaction Record (Long PTR) buffer is allocated for each request message that arrives at an MP using a Pending Answer Timer above 10 seconds and is de-allocated when the corresponding answer message is sent back. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"MaxConnsThisMp": {
"description": "The maximum number of Diameter connections the DA-MP can have configured at any one time.",
"maximum": 50,
"minimum": 0,
"default": 20,
"type": "integer"
},
"MaxPendingTransactions": {
"description": "The maximum number of outstanding Requests the DA-MP can have at one time. Each Request routed to a peer is considered one pending transaction.",
"type": "integer"
},
"MpEngIngressMps": {
"description": "The maximum ingress message rate that a DA-MP will support without overload. This value provides a limit to the total Reserved Ingress MPS of all Diameter Connections assigned to the DA-MP.",
"type": "integer"
},
"MpMaxIngressMps": {
"description": "The maximum ingress message rate that will be delivered to the Diameter Routing Layer from the Diameter Connection Layer on an DA-MP. Messages received above this rate are automatically discarded by the Diameter Connection Layer.",
"type": "integer"
},
"MpRxAllRateCriticalClear": {
"description": "The ingress message rate below which a critical alarm is cleared.",
"type": "integer"
},
"MpRxAllRateCriticalSet": {
"description": "The ingress message rate below which a critical alarm is raised.",
"type": "integer"
},
"MpRxAllRateMajorClear": {
"description": "The ingress message rate below which a major alarm is cleared.",
"type": "integer"
},
"MpRxAllRateMajorSet": {
"description": "The ingress message rate below which a major alarm is raised",
"type": "integer"
},
"MpRxAllRateMinorClear": {
"description": "The ingress message rate below which a minor alarm is cleared.",
"type": "integer"
},
"MpRxAllRateMinorSet": {
"description": "The ingress message rate below which a minor alarm is raised",
"type": "integer"
},
"MpRxDiamAllLenCriticalClear": {
"description": "The Average Message Size above which a critical alarm is cleared.",
"type": "integer"
},
"MpRxDiamAllLenCriticalSet": {
"description": "The Average Message Size above which a critical alarm is set.",
"type": "integer"
},
"MpRxDiamAllLenMajorClear": {
"description": "The Average Message Size above which a major alarm is cleared.",
"type": "integer"
},
"MpRxDiamAllLenMajorSet": {
"description": "The Average Message Size above which a major alarm is raised.",
"type": "integer"
},
"MpRxDiamAllLenMinorClear": {
"description": "The Average Message Size above which a minor alarm is cleared.",
"type": "integer"
},
"MpRxDiamAllLenMinorSet": {
"description": "The Average Message Size above which a minor alarm is raised.",
"type": "integer"
},
"OtherMask": {
"description": "The CPU affinity mask that assigns StackTimer and DbChangeAgent threads to specific internal cores in the DA-MP.",
"type": "integer"
},
"PdraAnswerTaskThr": {
"description": "The number of answer task threads created in the P-DRA to process the Answer messages from the P-DRA Answer Message Queue.",
"type": "integer"
},
"PdraRequestTaskThr": {
"description": "The number of request task threads created in the P-DRA to process the Request messages from the P-DRA Request Message Queue.",
"type": "integer"
},
"PdraSbrEventTaskThr": {
"description": "The number of P-DRA SBR Event Task threads created in the P-DRA to process SBR Event messages from the P-DRA SBR Event Message Queue.",
"type": "integer"
},
"RbarApplTaskThr": {
"description": "The number of RBAR Application threads created in the Diameter Stack to process Request messages from the RBAR Request Message Queue.",
"type": "integer"
},
"RoutingMsgRateCriticalClear": {
"description": "The Diameter Routing Layer message processing rate below which a critical alarm is cleared.",
"type": "integer"
},
"RoutingMsgRateCriticalSet": {
"description": "The Diameter Routing Layer message processing rate below which a critical alarm is raised.",
"type": "integer"
},
"RoutingMsgRateMajorClear": {
"description": "The Diameter Routing Layer message processing rate below which a major alarm is cleared.",
"type": "integer"
},
"RoutingMsgRateMajorSet": {
"description": "The Diameter Routing Layer message processing rate below which a major alarm is raised",
"type": "integer"
},
"RoutingMsgRateMinorClear": {
"description": "The Diameter Routing Layer message processing rate below which a minor alarm is cleared",
"type": "integer"
},
"RoutingMsgRateMinorSet": {
"description": "The Diameter Routing Layer message processing rate below which a minor alarm is raised",
"type": "integer"
},
"RxBatchSize": {
"description": "The maximum number of ingress messages that can be received by the Diameter Connection Layer on a connection in a single receive thread read cycle.",
"type": "integer"
},
"RxCpaAnswerMsgQueue": {
"description": "The internal Answer message queue to the CPA Application within the Diameter Stack. This queue stores Answer messages as they arrive from Diameter Routing Layer to the CPA Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxCpaEventMsgQueue": {
"description": "The internal event message queue to the CPA Application within the Diameter Stack. This queue stores internal control messages as they arrive from Diameter Routing Layer to the CPA Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxCpaMsgRateCriticalClear": {
"description": "The ingress request rate for the CPA Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxCpaMsgRateCriticalSet": {
"description": "The ingress request rate for the CPA Application below which a critical alarm is raised",
"type": "integer"
},
"RxCpaMsgRateMajorClear": {
"description": "The ingress request rate for the CPA Application below which a major alarm is cleared.",
"type": "integer"
},
"RxCpaMsgRateMajorSet": {
"description": "The ingress request rate for the CPA Application below which a major alarm is raised.",
"type": "integer"
},
"RxCpaMsgRateMinorClear": {
"description": "The ingress request rate for the CPA Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxCpaMsgRateMinorSet": {
"description": "The ingress request rate for the CPA Application below which a minor alarm is raised.",
"type": "integer"
},
"RxCpaRequestMsgQueue": {
"description": "The internal Request message queue to the CPA Application within the Diameter Stack. This queue stores Request messages as they arrive from Diameter Routing Layer to the CPA Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxDmiwfMsgRateCriticalClear": {
"description": "The ingress request rate for the DM-IWF Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxDmiwfMsgRateCriticalSet": {
"description": "The ingress request rate for the DM-IWF Application below which a critical alarm is raised.",
"type": "integer"
},
"RxDmiwfMsgRateMajorClear": {
"description": "The ingress request rate for the DM-IWF Application below which a major alarm is cleared.",
"type": "integer"
},
"RxDmiwfMsgRateMajorSet": {
"description": "The ingress request rate for the DM-IWF Application below which a major alarm is raised.",
"type": "integer"
},
"RxDmiwfMsgRateMinorClear": {
"description": "The ingress request rate for the DM-IWF Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxDmiwfMsgRateMinorSet": {
"description": "The ingress request rate for the DM-IWF Application below which a minor alarm is raised.",
"type": "integer"
},
"RxFabrDpResponseMsgQueue": {
"description": "The internal DP message queue to the FABR Application within the Diameter Stack. This queue stores resposes as they arrive from DP to the FABR Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxFabrMsgRateCriticalClear": {
"description": "The ingress request rate for the FABR Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxFabrMsgRateCriticalSet": {
"description": "The ingress request rate for the FABR Application below which a critical alarm is raised.",
"type": "integer"
},
"RxFabrMsgRateMajorClear": {
"description": "The ingress request rate for the FABR Application below which a major alarm is cleared.",
"type": "integer"
},
"RxFabrMsgRateMajorSet": {
"description": "The ingress request rate for the FABR Application below which a major alarm is raised.",
"type": "integer"
},
"RxFabrMsgRateMinorClear": {
"description": "The ingress request rate for the FABR Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxFabrMsgRateMinorSet": {
"description": "The ingress request rate for the FABR Application below which a minor alarm is raised.",
"type": "integer"
},
"RxFabrRequestMsgQueue": {
"description": "The internal request message queue to the FABR Application within the Diameter Stack. This queue stores Request messages as they arrive from Diameter Routing Layer to the FABR Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxMsgRateMp": {
"description": "The ingress message rate measures the routable messages per second that the MP receives from the network. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxPdraAnswerMsgQueue": {
"description": "he maximum size of P-DRA Answer Message Queue.",
"type": "integer"
},
"RxPdraReqRate": {
"description": "This parameter is used to measure the average number of Diameter requests received by P-DRA from the DRL layer per second.",
"type": "integer"
},
"RxPdraRequestMsgQueue": {
"description": "The maximum size of the P-DRA Request Message Queue.",
"type": "integer"
},
"RxPdraSbrEventMsgQueue": {
"description": "The maximum size of P-DRA SBR Event Message Queue.",
"type": "integer"
},
"RxRbarMsgRateCriticalClear": {
"description": "The ingress request rate for the RBAR Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxRbarMsgRateCriticalSet": {
"description": "The ingress request rate for the RBAR Application below which a critical alarm is raised",
"type": "integer"
},
"RxRbarMsgRateMajorClear": {
"description": "The ingress request rate for the RBAR Application below which a major alarm is cleared",
"type": "integer"
},
"RxRbarMsgRateMajorSet": {
"description": "The ingress request rate for the RBAR Application below which a major alarm is raised",
"type": "integer"
},
"RxRbarMsgRateMinorClear": {
"description": "The ingress request rate for the RBAR Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxRbarMsgRateMinorSet": {
"description": "The ingress request rate for the RBAR Application below which a minor alarm is raised",
"type": "integer"
},
"RxRbarRequestMsgQueue": {
"description": "The internal request message queue to the RBAR Application within the Diameter Stack. This queue stores Request messages as they arrive from Diameter Routing Layer to the RBAR Application. Thresholds for minor, major and critical alarms are based on a fixed percentage of this maximum value.",
"type": "integer"
},
"RxThreadMask": {
"description": "The CPU affinity mask that assigns Receive threads to specific internal cores in the DA-MP.",
"type": "integer"
},
"RxThreadPool": {
"description": "The number of Diameter Connection Layer receive threads created to read Diameter messages from connections.",
"type": "integer"
},
"StackLayerMask": {
"description": "The CPU affinity mask that assigns Stack Tasks to specific internal cores in the DA-MP.",
"type": "integer"
},
"TxBatchSize": {
"description": "The maximum number of egress messages that can be transmitted by the Diameter Connection Layer on a connection in a single transmit thread write cycle.",
"type": "integer"
},
"TxThreadMask": {
"description": "The CPU affinity mask that assigns Transmit threads to specific internal cores in the DA-MP.",
"type": "integer"
},
"TxThreadPool": {
"description": "The number of Diameter Connection Layer transmit threads created to write Diameter messages to connections.",
"type": "integer"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
}
},
"required": [
"CL1DiscardPercent",
"CL2DiscardPercent",
"CL3DiscardPercent",
"ConvergenceTime",
"DOCMsgDiscardPercent"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"SS7MPElements": {
"description": "Describes the fields on the SS7-MP of MP Profile.",
"items": {
"properties": {
"profileName": {
"description": "These are profile parameters of Mp profile.",
"items": {
"properties": {
"RxMdIwfIngressMsgRateCriticalClear": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a critical alarm is cleared.",
"type": "integer"
},
"RxMdIwfIngressMsgRateCriticalSet": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a critical alarm is raised.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMajorClear": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a major alarm is cleared.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMajorSet": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a major alarm is raised.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMinorClear": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a minor alarm is cleared.",
"type": "integer"
},
"RxMdIwfIngressMsgRateMinorSet": {
"description": "This parameter defines the sysmetric threshold value for the ingress request rate for the MD-IWF Application below which a minor alarm is raised.",
"type": "integer"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
}
},
"type": "object"
}
Example
{
"G6_Relay": {
"CL1DiscardPercent" : 0,
"CL2DiscardPercent" : 20,
"CL3DiscardPercent" : 40,
"ConvergenceTime" : 1000,
"DOCMsgDiscardPercent" : 20
}
}
Diameter: MME/SGSN Topology Hiding Configuration Sets
MME/SGSN Topology Hiding Configuration Sets provide information that is used to perform MME/SGSN Topology Hiding for Protected Networks. Each Protected Network can reference a single MME/SGSN Topology Hiding Configuration Set.
All MME/SGSN Topology Hiding Configuration Set configuration is done at the NOAM.
/diameter/mmetopologyhidingcfgsets
get /diameter/mmetopologyhidingcfgsets
Returns all MME/SGSN Topology Hiding Configuration Sets configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those MME/SGSN Topology Hiding Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/mmetopologyhidingcfgsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mmetopologyhidingcfgset/mmetopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this MME/SGSN Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying MME/SGSN Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the MME/SGSN Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. MME/SGSN Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestMmeTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/mmetopologyhidingcfgsets
Adds a new MME/SGSN Topology Hiding Configuration Set to the DSR configuration. The new MME/SGSN Topology Hiding Configuration Set must have a name that is unique to the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mmetopologyhidingcfgset/mmetopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this MME/SGSN Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying MME/SGSN Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the MME/SGSN Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. MME/SGSN Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestMmeTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/mmetopologyhidingcfgsets/{name}
get /diameter/mmetopologyhidingcfgsets/{name}
Returns the configuration details for the specified MME/SGSN Topology Hiding Configuration Set. If the specified MME/SGSN Topology Hiding Configuration Set does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/mmetopologyhidingcfgsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mmetopologyhidingcfgset/mmetopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this MME/SGSN Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying MME/SGSN Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the MME/SGSN Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. MME/SGSN Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestMmeTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/mmetopologyhidingcfgsets/{name}
Updates the configuration for the specified MME/SGSN Topology Hiding Configuration Set. If the provided MME/SGSN Topology Hiding Configuration Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mmetopologyhidingcfgset/mmetopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this MME/SGSN Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying MME/SGSN Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 300,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the MME/SGSN Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. MME/SGSN Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestMmeTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
delete /diameter/mmetopologyhidingcfgsets/{name}
Deletes the specified MME/SGSN Topology Hiding Configuration Set from the NOAM configuration. An MME/SGSN Topology Hiding Configuration Set can only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: MP Profile Assignments
An MP Profile is a set of parameters that defines certain capacity and performance characteristics to the software running on the MP, effectively tuning the MP for a specific application and deployment environment. Each DA-MP or SS7-MP server must have a Profile assigned before it can fulfill its role within the DSR. When an MP is first added to a DSR, it has no Profile assigned, and does not come up successfully until a Profile has been assigned and the MP is restarted. If the assigned Profile of a running MP is ever changed, the new Profile does not take effect until the MP is restarted.
Unassigned MPs will default to a configurationLevel of 0. Attempting to filter based on configurationLevel will not return any unassigned MPs.
Assignment of MP Profiles is always done at the SOAM.
/diameter/mpprofileassignments
get /diameter/mpprofileassignments
Returns a list of all MPs configured at the SOAM and the MP Profile assigned to each. MPs that are configured, but for which no Profile has yet been assigned, appear in the response with the Unassigned profile.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/mpprofileassignmentCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mpprofileassignment/mpprofileassignment.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"hostname": {
"description": "The topology-assiged name for a DA-MP or SS7-MP Server.",
"type": "string"
},
"profileName": {
"type": "string",
"enum": ["Unassigned", "G6_Relay", "G8G9_Relay", "G7_Relay", "G6_Database", "G8G9_Database", "G7_Database", "G6_Session", "G8G9_Session", "G7_Session", "G6_Session_Database", "G8G9_Session_Database", "G7_Session_Database", "VM_Relay", "VM_Database", "UDRVM_Database", "G8G9_MDIWF", "VM_MDIWF", "VM_6K_Mps", "VM_8K_Mps", "VM_10K_Mps", "VM_12K_Mps", "VM_14K_Mps", "VM_16K_Mps", "VM_18K_Mps", "VM_21K_Mps", "VM_24K_Mps", "VM_27K_Mps", "VM_30K_Mps","Gen9V2_Relay","Gen9V2_Database","Gen9V2_Session","VM_40K_Mps_FABR","VM_45K_Mps_RBAR","VM_35K_Mps"],
"description": "The specific MP Profile assigned to the MP server identified by hostname. Valid values are: Unassigned - the MP has not been assigned any Profile *** G6_Relay - G6 DA-MP half height blade running the relay application *** G8G9_Relay - G8/G9 DA-MP half height blade running the relay application *** G7_Relay - G7 DA-MP Full height blade running the relay application *** G6_Database - G6 DA-MP half height blade running relay and database applications *** G8G9_Database - G8/G9 DA-MP half height blade running relay and database applications *** G7_Database - G7 DA-MP Full height blade running relay and database applications *** G6_Session - G6 DA-MP half height blade running relay and session applications *** G8G9_Session - G8/G9 DA-MP half height blade running relay and session applications *** G7_Session - G7 DA-MP Full height blade running relay and session applications *** G6_Session_Database - G6 DA-MP half height blade running relay, session and database applications *** G8G9_Session_Database - G8/G9 DA-MP half height blade running relay, session and database applications *** G7_Session_Database - G7 DA-MP Full height blade running relay, session and database applications *** VM_Relay - Virtualized DA-MP on DL380 TVOE Guest running the relay application *** VM_Database - Virtualized DA-MP on DL380 TVOE Guest running relay and database applications *** UDRVM_Database - Virtualized MP running OCUDR application *** G8G9_MDIWF - G8/G9 half height blade performing MD-IWF application *** VM_MDIWF - Virtualized SS7-MP running MD-IWF application *** VM_6K_Mps - Virtualized DA-MP rated at 6K MPS for all configurations *** VM_8K_Mps - Virtualized DA-MP rated at 8K MPS for all configurations *** VM_10K_Mps - Virtualized DA-MP rated at 10K MPS for all configurations *** VM_12K_Mps - Virtualized DA-MP rated at 12K MPS for all configurations *** VM_14K_Mps - Virtualized DA-MP rated at 14K MPS for all configurations *** VM_16K_Mps - Virtualized DA-MP rated at 16K MPS for all configurations *** VM_18K_Mps - Virtualized DA-MP rated at 18K MPS for all configurations *** VM_21K_Mps - Virtualized DA-MP rated at 21K MPS for all configurations *** VM_24K_Mps - Virtualized DA-MP rated at 24K MPS for all configurations *** VM_27K_Mps - Virtualized DA-MP rated at 27K MPS for all configurations *** VM_30K_Mps - Virtualized DA-MP rated at 30K MPS for all configurations *** Gen9V2_Relay - G9v2 DA-MP blade running the relay application *** Gen9V2_Database - G9v2 DA-MP blade running relay and database applications *** Gen9V2_Session - G9v2 DA-MP blade running relay, database, and session applications *** VM_40K_Mps_FABR - Virtualized DA-MP rated at 40K MPS for all configurations *** VM_45K_Mps_RBAR - Virtualized DA-MP rated at 45K MPS for all configurations *** VM_35K_Mps - Virtualized DA-MP rated at 35K MPS for all configurations"
}
},
"required": [
"hostname",
"profileName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "56",
"hostname": "mpServer3",
"profileName": "G7_Session_Database"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/mpprofileassignments/{hostname}
get /diameter/mpprofileassignments/{hostname}
Returns the name of the MP Profile assigned to the specified MP server identified by hostname (the name of the MP server configured in the topology, using /topo/servers). If the specified MP Server does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/mpprofileassignmentItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mpprofileassignment/mpprofileassignment.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"hostname": {
"description": "The topology-assiged name for a DA-MP or SS7-MP Server.",
"type": "string"
},
"profileName": {
"type": "string",
"enum": ["Unassigned", "G6_Relay", "G8G9_Relay", "G7_Relay", "G6_Database", "G8G9_Database", "G7_Database", "G6_Session", "G8G9_Session", "G7_Session", "G6_Session_Database", "G8G9_Session_Database", "G7_Session_Database", "VM_Relay", "VM_Database", "UDRVM_Database", "G8G9_MDIWF", "VM_MDIWF", "VM_6K_Mps", "VM_8K_Mps", "VM_10K_Mps", "VM_12K_Mps", "VM_14K_Mps", "VM_16K_Mps", "VM_18K_Mps", "VM_21K_Mps", "VM_24K_Mps", "VM_27K_Mps", "VM_30K_Mps","Gen9V2_Relay","Gen9V2_Database","Gen9V2_Session","VM_40K_Mps_FABR","VM_45K_Mps_RBAR","VM_35K_Mps"],
"description": "The specific MP Profile assigned to the MP server identified by hostname. Valid values are: Unassigned - the MP has not been assigned any Profile *** G6_Relay - G6 DA-MP half height blade running the relay application *** G8G9_Relay - G8/G9 DA-MP half height blade running the relay application *** G7_Relay - G7 DA-MP Full height blade running the relay application *** G6_Database - G6 DA-MP half height blade running relay and database applications *** G8G9_Database - G8/G9 DA-MP half height blade running relay and database applications *** G7_Database - G7 DA-MP Full height blade running relay and database applications *** G6_Session - G6 DA-MP half height blade running relay and session applications *** G8G9_Session - G8/G9 DA-MP half height blade running relay and session applications *** G7_Session - G7 DA-MP Full height blade running relay and session applications *** G6_Session_Database - G6 DA-MP half height blade running relay, session and database applications *** G8G9_Session_Database - G8/G9 DA-MP half height blade running relay, session and database applications *** G7_Session_Database - G7 DA-MP Full height blade running relay, session and database applications *** VM_Relay - Virtualized DA-MP on DL380 TVOE Guest running the relay application *** VM_Database - Virtualized DA-MP on DL380 TVOE Guest running relay and database applications *** UDRVM_Database - Virtualized MP running OCUDR application *** G8G9_MDIWF - G8/G9 half height blade performing MD-IWF application *** VM_MDIWF - Virtualized SS7-MP running MD-IWF application *** VM_6K_Mps - Virtualized DA-MP rated at 6K MPS for all configurations *** VM_8K_Mps - Virtualized DA-MP rated at 8K MPS for all configurations *** VM_10K_Mps - Virtualized DA-MP rated at 10K MPS for all configurations *** VM_12K_Mps - Virtualized DA-MP rated at 12K MPS for all configurations *** VM_14K_Mps - Virtualized DA-MP rated at 14K MPS for all configurations *** VM_16K_Mps - Virtualized DA-MP rated at 16K MPS for all configurations *** VM_18K_Mps - Virtualized DA-MP rated at 18K MPS for all configurations *** VM_21K_Mps - Virtualized DA-MP rated at 21K MPS for all configurations *** VM_24K_Mps - Virtualized DA-MP rated at 24K MPS for all configurations *** VM_27K_Mps - Virtualized DA-MP rated at 27K MPS for all configurations *** VM_30K_Mps - Virtualized DA-MP rated at 30K MPS for all configurations *** Gen9V2_Relay - G9v2 DA-MP blade running the relay application *** Gen9V2_Database - G9v2 DA-MP blade running relay and database applications *** Gen9V2_Session - G9v2 DA-MP blade running relay, database, and session applications *** VM_40K_Mps_FABR - Virtualized DA-MP rated at 40K MPS for all configurations *** VM_45K_Mps_RBAR - Virtualized DA-MP rated at 45K MPS for all configurations *** VM_35K_Mps - Virtualized DA-MP rated at 35K MPS for all configurations"
}
},
"required": [
"hostname",
"profileName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "56",
"hostname": "mpServer3",
"profileName": "G7_Session_Database"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/mpprofileassignments/{hostname}
Updates the MP Profile assigned to the MP server identified by hostname (the name of the MP server configured in the topology using /topo/servers). If the specified MP server does not exist in the SOAM's configuration, or the provided MP Profile is not valid, the assignment fails, resulting in an error message returned within the HTTP response. Clients should never specify Unassigned as the Profile to be assigned, as unassigning a Profile from an MP is not a supported operation.
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/mpprofileassignment/mpprofileassignment.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"hostname": {
"description": "The topology-assiged name for a DA-MP or SS7-MP Server.",
"type": "string"
},
"profileName": {
"type": "string",
"enum": ["Unassigned", "G6_Relay", "G8G9_Relay", "G7_Relay", "G6_Database", "G8G9_Database", "G7_Database", "G6_Session", "G8G9_Session", "G7_Session", "G6_Session_Database", "G8G9_Session_Database", "G7_Session_Database", "VM_Relay", "VM_Database", "UDRVM_Database", "G8G9_MDIWF", "VM_MDIWF", "VM_6K_Mps", "VM_8K_Mps", "VM_10K_Mps", "VM_12K_Mps", "VM_14K_Mps", "VM_16K_Mps", "VM_18K_Mps", "VM_21K_Mps", "VM_24K_Mps", "VM_27K_Mps", "VM_30K_Mps","Gen9V2_Relay","Gen9V2_Database","Gen9V2_Session","VM_40K_Mps_FABR","VM_45K_Mps_RBAR","VM_35K_Mps"],
"description": "The specific MP Profile assigned to the MP server identified by hostname. Valid values are: Unassigned - the MP has not been assigned any Profile *** G6_Relay - G6 DA-MP half height blade running the relay application *** G8G9_Relay - G8/G9 DA-MP half height blade running the relay application *** G7_Relay - G7 DA-MP Full height blade running the relay application *** G6_Database - G6 DA-MP half height blade running relay and database applications *** G8G9_Database - G8/G9 DA-MP half height blade running relay and database applications *** G7_Database - G7 DA-MP Full height blade running relay and database applications *** G6_Session - G6 DA-MP half height blade running relay and session applications *** G8G9_Session - G8/G9 DA-MP half height blade running relay and session applications *** G7_Session - G7 DA-MP Full height blade running relay and session applications *** G6_Session_Database - G6 DA-MP half height blade running relay, session and database applications *** G8G9_Session_Database - G8/G9 DA-MP half height blade running relay, session and database applications *** G7_Session_Database - G7 DA-MP Full height blade running relay, session and database applications *** VM_Relay - Virtualized DA-MP on DL380 TVOE Guest running the relay application *** VM_Database - Virtualized DA-MP on DL380 TVOE Guest running relay and database applications *** UDRVM_Database - Virtualized MP running OCUDR application *** G8G9_MDIWF - G8/G9 half height blade performing MD-IWF application *** VM_MDIWF - Virtualized SS7-MP running MD-IWF application *** VM_6K_Mps - Virtualized DA-MP rated at 6K MPS for all configurations *** VM_8K_Mps - Virtualized DA-MP rated at 8K MPS for all configurations *** VM_10K_Mps - Virtualized DA-MP rated at 10K MPS for all configurations *** VM_12K_Mps - Virtualized DA-MP rated at 12K MPS for all configurations *** VM_14K_Mps - Virtualized DA-MP rated at 14K MPS for all configurations *** VM_16K_Mps - Virtualized DA-MP rated at 16K MPS for all configurations *** VM_18K_Mps - Virtualized DA-MP rated at 18K MPS for all configurations *** VM_21K_Mps - Virtualized DA-MP rated at 21K MPS for all configurations *** VM_24K_Mps - Virtualized DA-MP rated at 24K MPS for all configurations *** VM_27K_Mps - Virtualized DA-MP rated at 27K MPS for all configurations *** VM_30K_Mps - Virtualized DA-MP rated at 30K MPS for all configurations *** Gen9V2_Relay - G9v2 DA-MP blade running the relay application *** Gen9V2_Database - G9v2 DA-MP blade running relay and database applications *** Gen9V2_Session - G9v2 DA-MP blade running relay, database, and session applications *** VM_40K_Mps_FABR - Virtualized DA-MP rated at 40K MPS for all configurations *** VM_45K_Mps_RBAR - Virtualized DA-MP rated at 45K MPS for all configurations *** VM_35K_Mps - Virtualized DA-MP rated at 35K MPS for all configurations"
}
},
"required": [
"hostname",
"profileName"
],
"type": "object"
}
Example
{
"configurationLevel": "56",
"hostname": "mpServer3",
"profileName": "G7_Session_Database"
}
Diameter: Options
Options (sometimes referred to as System Options) is a collection of parameters that govern various aspects of the DSR's operation. The parameters found here tend to relate to specific features of the DSR, rather than to any particular Managed Object. The Options fall into the following categories/features:
- General options (system-wide parameters not necessarily related to any one feature of DSR operation)
- Alarm Threshold options
- Message Copy options
- RADIUS UDP options
- Dynamic Peer Discovery options
- Priority Service options
There is a single instance of this resource, which contains all of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All Options configuration is done at the SOAM.
/diameter/options
get /diameter/options
Returns the set of current values for the Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/optionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/option/option.json",
"properties": {
"alarmBudget": {
"description": "The total number of alarms allowed in the alarm budget. This is a fixed value. The sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"readOnly": true,
"type": "integer"
},
"alarmGroupFeatureEnabled": {
"description": "If true, Alarm Group feature functionality is enabled for the Peer Nodes and Connections. Peers (/diameter/peers) and Connections (/diameter/connections) must be added respectively to the Peer Node Alarm Group (/diameter/peernodealarmgroups) and Connection Alarm Group (/diameter/connectionalarmgroups) for Alarm Group feature. Enabling of Alarm Group feature will automatically disable the Alarm Aggregation feature for all the Peer Nodes and Connections. If false, Alarm Group feature functionality is disabled and Alarm Aggregation feature will work for Peer Nodes and Connections.",
"default": false,
"type" : "boolean"
},
"congestionDiscardPolicy": {
"description": "The order of priority and/or color-based traffic segments when determining which messages should continue routing and which should be diverted or discarded during times of congestion. Typical value is 2",
"enum": [0, 1, 2],
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCriticalAggAlarmThreshold": {
"description": "When the number of fixed Connection (/diameter/connections) failure alarms raised by a single DA-MP exceeds this threshold: 1) the already-raised major aggregate fixed Connection failure alarm for that DA-MP is cleared, and 2) a single aggregate fixed Connection failure alarm of critical severity is raised by the SOAM against that DA-MP. The value of connCriticalAggAlarmThreshold is not included in the available alarm budget. Set connCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for fixed Connection failures.",
"minimum": 0,
"type": "integer"
},
"connMajorAggAlarmThreshold": {
"description": "When the number of fixed Connection (/diameter/connections) failure alarms raised by a single DA-MP exceeds this threshold: 1) all individual fixed Connection failure alarms raised to that point are cleared, and 2) a single aggregate fixed Connection failure alarm of major severity is raised by the SOAM against that DA-MP. The value of connMajorAggAlarmThreshold is included in the available alarm budget, multiplied by the number of DA-MP in the DSR. So the sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"connReservedIngressMpsScaling": {
"description": "Percent of DA-MP engineered Ingress MPS used by each DA-MP when validating the Reserved Ingress MPS for a newly received Connection (/diameter/connections). A newly received Connection is rejected if the total Connection Reserved Ingress MPS for fixed and already-established IPFE Connections would exceed the DA-MP's Engineering Ingress MPS, scaled by connReservedIngressMpsScaling. Typical value is 50.",
"readOnly": true,
"type": "integer"
},
"diameterEngMessageSize": {
"description": "The engineered message size of Diameter messages supported by the DSR.",
"readOnly": true,
"type": "integer"
},
"dpdRealmExpiryMajAlarmThresholdHrs": {
"description": "The time, in hours, before the expiration of a dynamically-discovered Realm, at which a major alarm is raised to indicate that Realm expiration is approaching. A value of zero means no major alarm is raised to alert of the pending Realm expiration. If both dpdRealmExpiryMinAlarmThresholdHrs and dpdRealmExpiryMajAlarmThresholdHrs are non-zero, the value for dpdRealmExpiryMinAlarmThresholdHrs must be greater than the value for dpdRealmExpiryMajAlarmThresholdHrs. Typical value is 1.",
"maximum": 167,
"minimum": 0,
"type": "integer"
},
"dpdRealmExpiryMinAlarmThresholdHrs": {
"description": "The time, in hours, before the expiration of a dynamically-discovered Realm, at which a minor alarm is raised to indicate that Realm expiration is approaching. A value of zero means no minor alarm is raised to alert of the pending Realm expiration. If both dpdRealmExpiryMinAlarmThresholdHrs and dpdRealmExpiryMajAlarmThresholdHrs are non-zero, the value for dpdRealmExpiryMinAlarmThresholdHrs must be greater than the value for dpdRealmExpiryMajAlarmThresholdHrs. Typical value is 6.",
"maximum": 168,
"minimum": 0,
"type": "integer"
},
"encodeFqdnInLowerCase": {
"description": "If false, FQDNs are encoded as configured. Otherwise, they are encoded in all lower case. Typical value is true.",
"type": "boolean"
},
"etgMode": {
"description": "Defines the type of message throttling that the system will support for all ETGs (/diameter/egressthrottlegroups). When set to Threshold (legacy mode), Requests are enforced based on the congestion level of the ETG. When set to Limit , the egress message rate is shaped according to the maximum message and pending transaction rate, the system discard policy, and the current mix of requests by message color and priority. Typical value is Threshold.",
"enum": [
"Threshold",
"Limit"
],
"type": "string"
},
"excessiveRerouteAbateThreshold": {
"description": "Excessive Reroute Alarm is cleared when percentage of sum of rerouted messages due to Answer Response and/or Answer Timeout to the total requests forwarded is less than excessiveRerouteAbateThreshold for configured Abatement Time. Typical value is 15.",
"maximum": 99,
"minimum": 0,
"type": "integer"
},
"excessiveRerouteOnsetThreshold": {
"description": "Excessive Reroute Alarm is raised when percentage of sum of rerouted messages due to Answer Response and/or Answer Timeout to the total requests forwarded exceeds the excessiveRerouteOnsetThreshold value. Typical value is 20.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"ipfeConnCriticalAggAlarmThreshold": {
"description": "When the number of IPFE (floating) Connection (/diameter/connections) failure alarms raised exceeds this threshold: 1) the already-raised major aggregate IPFE Connection failure alarm is cleared, and 2) a single aggregate IPFE Connection failure alarm of critical severity is raised by the SOAM. The value of ipfeCriticalAggAlarmThreshold is not included in the available alarm budget. Set ipfeCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for IPFE Connection failures.",
"minimum": 0,
"type": "integer"
},
"ipfeConnMajorAggAlarmThreshold": {
"description": "When the number of IPFE (floating) Connection (/diameter/connections) failure alarms exceeds this threshold: 1) all individual IPFE Connection failure alarms raised to that point are cleared, and 2) a single aggregate IPFE Connection failure alarm of major severity is raised by the SOAM. The value of ipfeMajorAggAlarmThreshold is included in the available alarm budget. So the sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"mccsForRfMsgCopy": {
"description": "List of Configured Message Copy Configuration Set Name. Rf message copy will use the selected message Copy Configuration set.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgCopyDisableCongLevel": {
"description": "If a MP is at or above the congestion level specified by msgCopyDisableCongLevel, the message copy functionality is disabled on that MP. Typical value is Cl1.",
"enum": [
"Cl1",
"Cl2"
],
"type": "string"
},
"msgCopyFeatureEnabled": {
"description": "When set to true, the message copy feature is enabled for the DSR. When set to false, the message copy feature is disabled. Typical value is false.",
"type": "boolean"
},
"ngnPs16PriorityAdminStateEnabled": {
"description": "When set to true, system will support 16 internal message priorities (0-15). When set to false, system will support 5 internal message priorities (0-4).",
"type": "boolean"
},
"ngnPsAdminStateEnabled": {
"description": "When set to true, DSR provides NGN-PS treatment to applicable messages. When set to false, the NGN-PS feature is disabled. Typical value is false.",
"type": "boolean"
},
"ngnPsAnswerPriorityMode": {
"description": "Used for assigning priority to Answer messages. When set to HighestPriority, Answers have the highest priority (or 1 lower than Highest when ngnPsAdminStateEnabled is set to true. When this method is selected, DRMP AVPs in Answer messages are ignored. When set to RequestPriority, Answers have the same priority as Requests.",
"enum": [
"HighestPriority",
"RequestPriority"
],
"type": "string"
},
"ngnPsCxAdminStateEnabled": {
"description": "When set to true, the NGN-PS feature is enabled for Cx/Dx messages. When set to false, DSR does not provide NGN-PS treatment to Cx/Dx messages. ngnPsCxAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Cx/Dx messages is provided NGN-PS treatment even if ngnPsCxAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsDhAdminStateEnabled": {
"description": "When set to true, the NGN-PS feature is enabled for Dh/Sh messages. When set to false, DSR is not provided NGN-PS treatment to Dh/Sh messages. ngnPsDhAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Dh/Sh messages is provided NGN-PS treatment even if ngnPsDhAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsGxAdminStateEnabled": {
"description": "When set to true, the NGN-PS feature is enabled for Gx messages. When set to false, DSR is not provided NGN-PS treatment to Gx messages. ngnPsGxAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Gx messages is provided NGN-PS treatment even if ngnPsGxAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsGxAdvancedPriority": {
"description": "The Access Network priority provided to NGN-PS subscribed user equipment. Affects the tagging of Gx CCR messages for NGN-PS treatment. Not applicable if ngnPsGxAdminStateEnabled is false.",
"enum": [
"Hss",
"None",
"Spr"
],
"type": "string"
},
"ngnPsGxArp": {
"description": "List of up to five priority levels contained in Gx messages which can be treated as NGN-PS messages. Each array element must be an integer between 1 and 15, inclusive. Not applicable if ngnPsGxAdminStateEnabled is false.",
"items": {
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"ngnPsMaxMessageRatePercentage": {
"description": "Defines the maximum ingress NGN-PS message rate supported, as a percentage of the engineered DA-MP message rate. NGN-PS traffic in excess of this rate is not considered inviolable. Typical value is 3.",
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"ngnPsMaxNormalRequestPriority": {
"description": "Defines the maximum priority that can be assigned to an ingress normal (i.e., non-NGN-PS) Request message. This value is set by the DSR and is not client configurable.",
"maximum": 15,
"minimum": 0,
"readonly": true,
"type": "integer"
},
"ngnPsMaxPriority0Allowed": {
"description": "Defines the maximum priority that will be converted to priority '0' when a message or stack event is sent from a 16 priority scheme system to a 5-priority scheme system. Typical value is 5.",
"maximum": 13,
"minimum": 0,
"type": "integer"
},
"ngnPsMaxPriority1Allowed": {
"description": "Defines the maximum priority that will be converted to priority '1' when a message or stack event is sent from a 16 priority scheme system to a 5-priority scheme system. Typical value is 10.",
"maximum": 14,
"minimum": 1,
"type": "integer"
},
"ngnPsMaxPriority2Allowed": {
"description": "Defines the maximum priority that will be converted to priority '2' when a message or stack event is sent from a 16 priority scheme system to a 5-priority scheme system. Typical value is 14.",
"maximum": 15,
"minimum": 2,
"type": "integer"
},
"ngnPsMinimumAnswerPriority": {
"description": "Defines the minimum priority which DSR will assign to ingress Diameter Answer message. This value is not user configurable and it's value is derived internally.",
"enum": [
"P0",
"P3",
"P14",
"P15"
],
"readonly": true,
"type": "string"
},
"ngnPsMinimumInviolablePriority": {
"description": "Defines the minimum priority which DSR will consider inviolable from a message priority treatment. A message with a priority greater than or equal to this attribute is not subject to congestion controls. This value is set by the DSR and is not client configurable.",
"enum": [
"P3",
"P4",
"P15",
"P99"
],
"readonly": true,
"type": "string"
},
"ngnPsRxAdminStateEnabled": {
"description": "If true, the NGN-PS feature is enabled for Rx messages. When set to false, DSR is not provided NGN-PS treatment to Rx messages. ngnPsRxAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Rx messages is provided NGN-PS treatment even if ngnPsRxAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsRxMpsAvpValue": {
"description": "An Rx AAR message is considered an NGN-PS message candidate if it contains an MPS-Identifier AVP whose value identical to ngnPsRxMpsAvpValue. Not applicable if ngnPsRxAdminStateEnabled is false.",
"type": "string"
},
"peerNodeCriticalAggAlarmThreshold": {
"description": "When the number of Peer Node (/diameter/peernodes) failure alarms raised by the DSR exceeds this threshold: 1) all individual Peer Node failure alarms raised to that point are cleared, and 2) a single aggregate Peer Node failure alarm of critical severity is raised by the SOAM. The sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"radiusUdpClientSockRecvSize": {
"description": "The socket receive buffer size for incoming UDP messages received from RADIUS servers. Typical value is 126000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusUdpClientSockSendSize": {
"description": "The socket send buffer size for outgoing UDP messages sent to RADIUS servers. Typical value is 126000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusUdpServerSockRecvSize": {
"description": "The socket send buffer size for incoming UDP messages received from RADIUS clients. Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusUdpServerSockSendSize": {
"description": "The socket send buffer size for outgoing UDP messages sent to RADIUS clients. Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusAAARouteList": {
"description": "List of Configured Route List name. Radius Routing Tables will use the selected route list for routing.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusMPNRouteList": {
"description": "List of Configured Route List name. Radius Routing Tables will use the selected route list for routing.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusUMFRouteList": {
"description": "List of Configured Route List name. Radius Routing Tables will use the selected route list for routing.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"redirectAnsProcessingEnabled": {
"description": "If true, redirect notification response processing is enabled, and the DSR acts on any redirect information it receives in an answer message from a downstream Peer Node (/diameter/peernodes). If false, any answer message received by the DSR is simply passed through to the upstream Peer Node. Typical value is false.",
"type": "boolean"
},
"redirectApplicationRouteTableName": {
"description": "Name of the Application Route Table used to process a redirected request, if redirectAnsProcessingEnabled is true. Not applicable if redirectAnsProcessingEnabled is false.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"redirectPeerRouteTableName": {
"description": "Name of the Peer Route Table used to process a redirected request, if redirectAnsProcessingEnabled is true. Not applicable if redirectAnsProcessingEnabled is false.",
"maxLength": 32,
"pattern" : "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rfMsgCopyFeatureEnabled": {
"description": "When set to true, the Rf message copy feature is enabled for the DSR. When set to false, the Rf message copy feature is disabled. Default value is false. Rf message copy feature can be enabled only if Message copy feature is enabled. Rf message copy feature can be independently disabled even if Message copy feature is enabled. If Message copy feature is asked to disable, then Rf message copy feature should also be requested to disable along with the Message copy feature.",
"type": "boolean"
},
"routeListCriticalAggAlarmThreshold": {
"description": "When the number of Route List (/diameter/routelists) failure alarms raised by the DSR exceeds this threshold: 1) all individual Route List failure alarms raised to that point are cleared, and 2) a single aggregate Route List failure alarm of critical severity is raised by the SOAM. The sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"peerPingFeatureEnabled": {
"description": "If true, an ICMP ping echo is sent to the next-hop of every remote Peer (/diameter/peernodes) every two minutes. This is useful for keeping switch address tables up to date.",
"type" : "boolean"
}
},
"required": [
"connCriticalAggAlarmThreshold",
"connMajorAggAlarmThreshold",
"dpdRealmExpiryMajAlarmThresholdHrs",
"dpdRealmExpiryMinAlarmThresholdHrs",
"ipfeConnCriticalAggAlarmThreshold",
"ipfeConnMajorAggAlarmThreshold",
"encodeFqdnInLowerCase",
"excessiveRerouteAbateThreshold",
"excessiveRerouteOnsetThreshold",
"msgCopyDisableCongLevel",
"msgCopyFeatureEnabled",
"ngnPsAdminStateEnabled",
"ngnPsMaxMessageRatePercentage",
"peerNodeCriticalAggAlarmThreshold",
"peerPingFeatureEnabled",
"radiusUdpClientSockRecvSize",
"radiusUdpClientSockSendSize",
"radiusUdpServerSockRecvSize",
"radiusUdpServerSockSendSize",
"redirectAnsProcessingEnabled",
"routeListCriticalAggAlarmThreshold"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"alarmBudget": 3000,
"alarmGroupFeatureEnabled": false,
"configurationLevel": "390",
"connCriticalAggAlarmThreshold": 100,
"connMajorAggAlarmThreshold": 50,
"connReservedIngressMpsScaling": 100,
"diameterEngMessageSize": 60000,
"dpdRealmExpiryMajAlarmThresholdHrs": 1,
"dpdRealmExpiryMinAlarmThresholdHrs": 6,
"encodeFqdnInLowerCase": true,
"excessiveRerouteAbateThreshold": 15,
"excessiveRerouteOnsetThreshold": 20,
"ipfeConnCriticalAggAlarmThreshold": 200,
"ipfeConnMajorAggAlarmThreshold": 100,
"mccsForRfMsgCopy":"MsgCopyConfigSet1",
"msgCopyDisableCongLevel": "Cl1",
"msgCopyFeatureEnabled": false,
"ngnPsAdminStateEnabled": false,
"ngnPsCxAdminStateEnabled": false,
"ngnPsDhAdminStateEnabled": false,
"ngnPsGxAdminStateEnabled": true,
"ngnPsGxAdvancedPriority": "None",
"ngnPsGxArp": [
3,
6,
10
],
"ngnPsMaxMessageRatePercentage": 3,
"ngnPsMinimumAnswerPriority": "P3",
"ngnPsMinimumInviolablePriority": "P3",
"ngnPsRxAdminStateEnabled": true,
"ngnPsRxMpsAvpValue": "testValue",
"peerNodeCriticalAggAlarmThreshold": 20,
"peerPingFeatureEnabled" : false,
"radiusUdpClientSockRecvSize": 126000,
"radiusUdpClientSockSendSize": 126000,
"radiusUdpServerSockRecvSize": 1000000,
"radiusUdpServerSockSendSize": 1000000,
"radiusAAARouteList": "RouteList1",
"radiusMPNRouteList": "RouteList2",
"radiusUMFRouteList": "RouteList3",
"redirectAnsProcessingEnabled": true,
"redirectApplicationRouteTableName": "ARTName",
"redirectPeerRouteTableName": "PRTName",
"rfMsgCopyFeatureEnabled": false,
"routeListCriticalAggAlarmThreshold": 25
},
"messages":
[
],
"links":
{
},
"status":
true
}
put /diameter/options
Updates the Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, and then PUT the Options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/option/option.json",
"properties": {
"alarmBudget": {
"description": "The total number of alarms allowed in the alarm budget. This is a fixed value. The sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"readOnly": true,
"type": "integer"
},
"alarmGroupFeatureEnabled": {
"description": "If true, Alarm Group feature functionality is enabled for the Peer Nodes and Connections. Peers (/diameter/peers) and Connections (/diameter/connections) must be added respectively to the Peer Node Alarm Group (/diameter/peernodealarmgroups) and Connection Alarm Group (/diameter/connectionalarmgroups) for Alarm Group feature. Enabling of Alarm Group feature will automatically disable the Alarm Aggregation feature for all the Peer Nodes and Connections. If false, Alarm Group feature functionality is disabled and Alarm Aggregation feature will work for Peer Nodes and Connections.",
"default": false,
"type" : "boolean"
},
"congestionDiscardPolicy": {
"description": "The order of priority and/or color-based traffic segments when determining which messages should continue routing and which should be diverted or discarded during times of congestion. Typical value is 2",
"enum": [0, 1, 2],
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCriticalAggAlarmThreshold": {
"description": "When the number of fixed Connection (/diameter/connections) failure alarms raised by a single DA-MP exceeds this threshold: 1) the already-raised major aggregate fixed Connection failure alarm for that DA-MP is cleared, and 2) a single aggregate fixed Connection failure alarm of critical severity is raised by the SOAM against that DA-MP. The value of connCriticalAggAlarmThreshold is not included in the available alarm budget. Set connCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for fixed Connection failures.",
"minimum": 0,
"type": "integer"
},
"connMajorAggAlarmThreshold": {
"description": "When the number of fixed Connection (/diameter/connections) failure alarms raised by a single DA-MP exceeds this threshold: 1) all individual fixed Connection failure alarms raised to that point are cleared, and 2) a single aggregate fixed Connection failure alarm of major severity is raised by the SOAM against that DA-MP. The value of connMajorAggAlarmThreshold is included in the available alarm budget, multiplied by the number of DA-MP in the DSR. So the sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"connReservedIngressMpsScaling": {
"description": "Percent of DA-MP engineered Ingress MPS used by each DA-MP when validating the Reserved Ingress MPS for a newly received Connection (/diameter/connections). A newly received Connection is rejected if the total Connection Reserved Ingress MPS for fixed and already-established IPFE Connections would exceed the DA-MP's Engineering Ingress MPS, scaled by connReservedIngressMpsScaling. Typical value is 50.",
"readOnly": true,
"type": "integer"
},
"diameterEngMessageSize": {
"description": "The engineered message size of Diameter messages supported by the DSR.",
"readOnly": true,
"type": "integer"
},
"dpdRealmExpiryMajAlarmThresholdHrs": {
"description": "The time, in hours, before the expiration of a dynamically-discovered Realm, at which a major alarm is raised to indicate that Realm expiration is approaching. A value of zero means no major alarm is raised to alert of the pending Realm expiration. If both dpdRealmExpiryMinAlarmThresholdHrs and dpdRealmExpiryMajAlarmThresholdHrs are non-zero, the value for dpdRealmExpiryMinAlarmThresholdHrs must be greater than the value for dpdRealmExpiryMajAlarmThresholdHrs. Typical value is 1.",
"maximum": 167,
"minimum": 0,
"type": "integer"
},
"dpdRealmExpiryMinAlarmThresholdHrs": {
"description": "The time, in hours, before the expiration of a dynamically-discovered Realm, at which a minor alarm is raised to indicate that Realm expiration is approaching. A value of zero means no minor alarm is raised to alert of the pending Realm expiration. If both dpdRealmExpiryMinAlarmThresholdHrs and dpdRealmExpiryMajAlarmThresholdHrs are non-zero, the value for dpdRealmExpiryMinAlarmThresholdHrs must be greater than the value for dpdRealmExpiryMajAlarmThresholdHrs. Typical value is 6.",
"maximum": 168,
"minimum": 0,
"type": "integer"
},
"encodeFqdnInLowerCase": {
"description": "If false, FQDNs are encoded as configured. Otherwise, they are encoded in all lower case. Typical value is true.",
"type": "boolean"
},
"etgMode": {
"description": "Defines the type of message throttling that the system will support for all ETGs (/diameter/egressthrottlegroups). When set to Threshold (legacy mode), Requests are enforced based on the congestion level of the ETG. When set to Limit , the egress message rate is shaped according to the maximum message and pending transaction rate, the system discard policy, and the current mix of requests by message color and priority. Typical value is Threshold.",
"enum": [
"Threshold",
"Limit"
],
"type": "string"
},
"excessiveRerouteAbateThreshold": {
"description": "Excessive Reroute Alarm is cleared when percentage of sum of rerouted messages due to Answer Response and/or Answer Timeout to the total requests forwarded is less than excessiveRerouteAbateThreshold for configured Abatement Time. Typical value is 15.",
"maximum": 99,
"minimum": 0,
"type": "integer"
},
"excessiveRerouteOnsetThreshold": {
"description": "Excessive Reroute Alarm is raised when percentage of sum of rerouted messages due to Answer Response and/or Answer Timeout to the total requests forwarded exceeds the excessiveRerouteOnsetThreshold value. Typical value is 20.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"ipfeConnCriticalAggAlarmThreshold": {
"description": "When the number of IPFE (floating) Connection (/diameter/connections) failure alarms raised exceeds this threshold: 1) the already-raised major aggregate IPFE Connection failure alarm is cleared, and 2) a single aggregate IPFE Connection failure alarm of critical severity is raised by the SOAM. The value of ipfeCriticalAggAlarmThreshold is not included in the available alarm budget. Set ipfeCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for IPFE Connection failures.",
"minimum": 0,
"type": "integer"
},
"ipfeConnMajorAggAlarmThreshold": {
"description": "When the number of IPFE (floating) Connection (/diameter/connections) failure alarms exceeds this threshold: 1) all individual IPFE Connection failure alarms raised to that point are cleared, and 2) a single aggregate IPFE Connection failure alarm of major severity is raised by the SOAM. The value of ipfeMajorAggAlarmThreshold is included in the available alarm budget. So the sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"mccsForRfMsgCopy": {
"description": "List of Configured Message Copy Configuration Set Name. Rf message copy will use the selected message Copy Configuration set.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgCopyDisableCongLevel": {
"description": "If a MP is at or above the congestion level specified by msgCopyDisableCongLevel, the message copy functionality is disabled on that MP. Typical value is Cl1.",
"enum": [
"Cl1",
"Cl2"
],
"type": "string"
},
"msgCopyFeatureEnabled": {
"description": "When set to true, the message copy feature is enabled for the DSR. When set to false, the message copy feature is disabled. Typical value is false.",
"type": "boolean"
},
"ngnPs16PriorityAdminStateEnabled": {
"description": "When set to true, system will support 16 internal message priorities (0-15). When set to false, system will support 5 internal message priorities (0-4).",
"type": "boolean"
},
"ngnPsAdminStateEnabled": {
"description": "When set to true, DSR provides NGN-PS treatment to applicable messages. When set to false, the NGN-PS feature is disabled. Typical value is false.",
"type": "boolean"
},
"ngnPsAnswerPriorityMode": {
"description": "Used for assigning priority to Answer messages. When set to HighestPriority, Answers have the highest priority (or 1 lower than Highest when ngnPsAdminStateEnabled is set to true. When this method is selected, DRMP AVPs in Answer messages are ignored. When set to RequestPriority, Answers have the same priority as Requests.",
"enum": [
"HighestPriority",
"RequestPriority"
],
"type": "string"
},
"ngnPsCxAdminStateEnabled": {
"description": "When set to true, the NGN-PS feature is enabled for Cx/Dx messages. When set to false, DSR does not provide NGN-PS treatment to Cx/Dx messages. ngnPsCxAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Cx/Dx messages is provided NGN-PS treatment even if ngnPsCxAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsDhAdminStateEnabled": {
"description": "When set to true, the NGN-PS feature is enabled for Dh/Sh messages. When set to false, DSR is not provided NGN-PS treatment to Dh/Sh messages. ngnPsDhAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Dh/Sh messages is provided NGN-PS treatment even if ngnPsDhAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsGxAdminStateEnabled": {
"description": "When set to true, the NGN-PS feature is enabled for Gx messages. When set to false, DSR is not provided NGN-PS treatment to Gx messages. ngnPsGxAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Gx messages is provided NGN-PS treatment even if ngnPsGxAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsGxAdvancedPriority": {
"description": "The Access Network priority provided to NGN-PS subscribed user equipment. Affects the tagging of Gx CCR messages for NGN-PS treatment. Not applicable if ngnPsGxAdminStateEnabled is false.",
"enum": [
"Hss",
"None",
"Spr"
],
"type": "string"
},
"ngnPsGxArp": {
"description": "List of up to five priority levels contained in Gx messages which can be treated as NGN-PS messages. Each array element must be an integer between 1 and 15, inclusive. Not applicable if ngnPsGxAdminStateEnabled is false.",
"items": {
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"ngnPsMaxMessageRatePercentage": {
"description": "Defines the maximum ingress NGN-PS message rate supported, as a percentage of the engineered DA-MP message rate. NGN-PS traffic in excess of this rate is not considered inviolable. Typical value is 3.",
"maximum": 15,
"minimum": 1,
"type": "integer"
},
"ngnPsMaxNormalRequestPriority": {
"description": "Defines the maximum priority that can be assigned to an ingress normal (i.e., non-NGN-PS) Request message. This value is set by the DSR and is not client configurable.",
"maximum": 15,
"minimum": 0,
"readonly": true,
"type": "integer"
},
"ngnPsMaxPriority0Allowed": {
"description": "Defines the maximum priority that will be converted to priority '0' when a message or stack event is sent from a 16 priority scheme system to a 5-priority scheme system. Typical value is 5.",
"maximum": 13,
"minimum": 0,
"type": "integer"
},
"ngnPsMaxPriority1Allowed": {
"description": "Defines the maximum priority that will be converted to priority '1' when a message or stack event is sent from a 16 priority scheme system to a 5-priority scheme system. Typical value is 10.",
"maximum": 14,
"minimum": 1,
"type": "integer"
},
"ngnPsMaxPriority2Allowed": {
"description": "Defines the maximum priority that will be converted to priority '2' when a message or stack event is sent from a 16 priority scheme system to a 5-priority scheme system. Typical value is 14.",
"maximum": 15,
"minimum": 2,
"type": "integer"
},
"ngnPsMinimumAnswerPriority": {
"description": "Defines the minimum priority which DSR will assign to ingress Diameter Answer message. This value is not user configurable and it's value is derived internally.",
"enum": [
"P0",
"P3",
"P14",
"P15"
],
"readonly": true,
"type": "string"
},
"ngnPsMinimumInviolablePriority": {
"description": "Defines the minimum priority which DSR will consider inviolable from a message priority treatment. A message with a priority greater than or equal to this attribute is not subject to congestion controls. This value is set by the DSR and is not client configurable.",
"enum": [
"P3",
"P4",
"P15",
"P99"
],
"readonly": true,
"type": "string"
},
"ngnPsRxAdminStateEnabled": {
"description": "If true, the NGN-PS feature is enabled for Rx messages. When set to false, DSR is not provided NGN-PS treatment to Rx messages. ngnPsRxAdminStateEnabled is superseded by ngnPsAdminStateEnabled; if ngnPsAdminStateEnabled is false, no Rx messages is provided NGN-PS treatment even if ngnPsRxAdminStateEnabled is true. Typical value is false.",
"type": "boolean"
},
"ngnPsRxMpsAvpValue": {
"description": "An Rx AAR message is considered an NGN-PS message candidate if it contains an MPS-Identifier AVP whose value identical to ngnPsRxMpsAvpValue. Not applicable if ngnPsRxAdminStateEnabled is false.",
"type": "string"
},
"peerNodeCriticalAggAlarmThreshold": {
"description": "When the number of Peer Node (/diameter/peernodes) failure alarms raised by the DSR exceeds this threshold: 1) all individual Peer Node failure alarms raised to that point are cleared, and 2) a single aggregate Peer Node failure alarm of critical severity is raised by the SOAM. The sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"radiusUdpClientSockRecvSize": {
"description": "The socket receive buffer size for incoming UDP messages received from RADIUS servers. Typical value is 126000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusUdpClientSockSendSize": {
"description": "The socket send buffer size for outgoing UDP messages sent to RADIUS servers. Typical value is 126000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusUdpServerSockRecvSize": {
"description": "The socket send buffer size for incoming UDP messages received from RADIUS clients. Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusUdpServerSockSendSize": {
"description": "The socket send buffer size for outgoing UDP messages sent to RADIUS clients. Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"radiusAAARouteList": {
"description": "List of Configured Route List name. Radius Routing Tables will use the selected route list for routing.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusMPNRouteList": {
"description": "List of Configured Route List name. Radius Routing Tables will use the selected route list for routing.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"radiusUMFRouteList": {
"description": "List of Configured Route List name. Radius Routing Tables will use the selected route list for routing.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"redirectAnsProcessingEnabled": {
"description": "If true, redirect notification response processing is enabled, and the DSR acts on any redirect information it receives in an answer message from a downstream Peer Node (/diameter/peernodes). If false, any answer message received by the DSR is simply passed through to the upstream Peer Node. Typical value is false.",
"type": "boolean"
},
"redirectApplicationRouteTableName": {
"description": "Name of the Application Route Table used to process a redirected request, if redirectAnsProcessingEnabled is true. Not applicable if redirectAnsProcessingEnabled is false.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"redirectPeerRouteTableName": {
"description": "Name of the Peer Route Table used to process a redirected request, if redirectAnsProcessingEnabled is true. Not applicable if redirectAnsProcessingEnabled is false.",
"maxLength": 32,
"pattern" : "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rfMsgCopyFeatureEnabled": {
"description": "When set to true, the Rf message copy feature is enabled for the DSR. When set to false, the Rf message copy feature is disabled. Default value is false. Rf message copy feature can be enabled only if Message copy feature is enabled. Rf message copy feature can be independently disabled even if Message copy feature is enabled. If Message copy feature is asked to disable, then Rf message copy feature should also be requested to disable along with the Message copy feature.",
"type": "boolean"
},
"routeListCriticalAggAlarmThreshold": {
"description": "When the number of Route List (/diameter/routelists) failure alarms raised by the DSR exceeds this threshold: 1) all individual Route List failure alarms raised to that point are cleared, and 2) a single aggregate Route List failure alarm of critical severity is raised by the SOAM. The sum of (connMajorAggAlarmThreshold * # DA-MPs), ipfeConnMajorAggAlarmThreshold, peerNodeCriticalAggAlarmThreshold, and routeListCriticalAggAlarmThreshold cannot exceed the alarm budget.",
"minimum": 1,
"type": "integer"
},
"peerPingFeatureEnabled": {
"description": "If true, an ICMP ping echo is sent to the next-hop of every remote Peer (/diameter/peernodes) every two minutes. This is useful for keeping switch address tables up to date.",
"type" : "boolean"
}
},
"required": [
"connCriticalAggAlarmThreshold",
"connMajorAggAlarmThreshold",
"dpdRealmExpiryMajAlarmThresholdHrs",
"dpdRealmExpiryMinAlarmThresholdHrs",
"ipfeConnCriticalAggAlarmThreshold",
"ipfeConnMajorAggAlarmThreshold",
"encodeFqdnInLowerCase",
"excessiveRerouteAbateThreshold",
"excessiveRerouteOnsetThreshold",
"msgCopyDisableCongLevel",
"msgCopyFeatureEnabled",
"ngnPsAdminStateEnabled",
"ngnPsMaxMessageRatePercentage",
"peerNodeCriticalAggAlarmThreshold",
"peerPingFeatureEnabled",
"radiusUdpClientSockRecvSize",
"radiusUdpClientSockSendSize",
"radiusUdpServerSockRecvSize",
"radiusUdpServerSockSendSize",
"redirectAnsProcessingEnabled",
"routeListCriticalAggAlarmThreshold"
],
"type": "object"
}
Example
{
"alarmBudget": 3000,
"alarmGroupFeatureEnabled": false,
"configurationLevel": "390",
"connCriticalAggAlarmThreshold": 100,
"connMajorAggAlarmThreshold": 50,
"connReservedIngressMpsScaling": 100,
"diameterEngMessageSize": 60000,
"dpdRealmExpiryMajAlarmThresholdHrs": 1,
"dpdRealmExpiryMinAlarmThresholdHrs": 6,
"encodeFqdnInLowerCase": true,
"excessiveRerouteAbateThreshold": 15,
"excessiveRerouteOnsetThreshold": 20,
"ipfeConnCriticalAggAlarmThreshold": 200,
"ipfeConnMajorAggAlarmThreshold": 100,
"mccsForRfMsgCopy":"MsgCopyConfigSet1",
"msgCopyDisableCongLevel": "Cl1",
"msgCopyFeatureEnabled": false,
"ngnPsAdminStateEnabled": false,
"ngnPsCxAdminStateEnabled": false,
"ngnPsDhAdminStateEnabled": false,
"ngnPsGxAdminStateEnabled": true,
"ngnPsGxAdvancedPriority": "None",
"ngnPsGxArp": [
3,
6,
10
],
"ngnPsMaxMessageRatePercentage": 3,
"ngnPsMinimumAnswerPriority": "P3",
"ngnPsMinimumInviolablePriority": "P3",
"ngnPsRxAdminStateEnabled": true,
"ngnPsRxMpsAvpValue": "testValue",
"peerNodeCriticalAggAlarmThreshold": 20,
"peerPingFeatureEnabled" : false,
"radiusUdpClientSockRecvSize": 126000,
"radiusUdpClientSockSendSize": 126000,
"radiusUdpServerSockRecvSize": 1000000,
"radiusUdpServerSockSendSize": 1000000,
"radiusAAARouteList": "RouteList1",
"radiusMPNRouteList": "RouteList2",
"radiusUMFRouteList": "RouteList3",
"redirectAnsProcessingEnabled": true,
"redirectApplicationRouteTableName": "ARTName",
"redirectPeerRouteTableName": "PRTName",
"rfMsgCopyFeatureEnabled": false,
"routeListCriticalAggAlarmThreshold": 25
}
Diameter: Path Topology Hiding Configuration Sets
Path Topology Hiding Configuration Sets provide information that is used to perform Path Topology Hiding for Protected Networks. Each Protected Network can reference a single Path Topology Hiding Configuration Set.
All Path Topology Hiding Configuration Set configuration is done at the NOAM.
/diameter/pathtopologyhidingcfgsets
get /diameter/pathtopologyhidingcfgsets
Returns all Path Topology Hiding Configuration Sets configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Path Topology Hiding Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/pathtopologyhidingcfgsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pathtopologyhidingcfgset/pathtopologyhidingcfgset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"encryptionKey": {
"description": "Encryption Key will be used for Error-Reporting Host obscuring. Encryption Key must be at most 16-Character alphanumeric String.",
"minLength": 1,
"maxLength": 16,
"pattern": "^([a-zA-Z0-9])+$",
"type": "string"
},
"hostnameSuffix": {
"description": "Hostname Suffixes for this Path Topology Hiding Configuration Set. Hostname Suffix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"name": {
"description": "Name for the Path Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pseudoProxy": {
"description": "Proxy-Host Pseudo Hostname will be used while replacing the host name in the Proxy-Host AVP. Proxy-Host Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoRouteRecord": {
"description": "Route-Record Pseudo Hostname will be used while replacing the Route-Record headers. Route-Record Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"required": [
"encryptionKey",
"hostnameSuffix",
"name",
"pseudoProxy",
"pseudoRouteRecord"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"encryptionKey": "TestEncKey123",
"hostnameSuffix": [
"oracle1.com",
"oracle2.com"
],
"name": "MmiTestPathTopologyHidingCfgSet",
"pseudoProxy": "test.oracle1.com",
"pseudoRouteRecord": "test.oracle2.com"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/pathtopologyhidingcfgsets
Adds a new Path Topology Hiding Configuration Set to the Diameter configuration. The new Path Topology Hiding Configuration Set must have a name that is unique to the NOAM's configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pathtopologyhidingcfgset/pathtopologyhidingcfgset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"encryptionKey": {
"description": "Encryption Key will be used for Error-Reporting Host obscuring. Encryption Key must be at most 16-Character alphanumeric String.",
"minLength": 1,
"maxLength": 16,
"pattern": "^([a-zA-Z0-9])+$",
"type": "string"
},
"hostnameSuffix": {
"description": "Hostname Suffixes for this Path Topology Hiding Configuration Set. Hostname Suffix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"name": {
"description": "Name for the Path Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pseudoProxy": {
"description": "Proxy-Host Pseudo Hostname will be used while replacing the host name in the Proxy-Host AVP. Proxy-Host Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoRouteRecord": {
"description": "Route-Record Pseudo Hostname will be used while replacing the Route-Record headers. Route-Record Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"required": [
"encryptionKey",
"hostnameSuffix",
"name",
"pseudoProxy",
"pseudoRouteRecord"
],
"type": "object"
}
Example
{
"encryptionKey": "TestEncKey123",
"hostnameSuffix": [
"oracle1.com",
"oracle2.com"
],
"name": "MmiTestPathTopologyHidingCfgSet",
"pseudoProxy": "test.oracle1.com",
"pseudoRouteRecord": "test.oracle2.com"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/pathtopologyhidingcfgsets/{name}
get /diameter/pathtopologyhidingcfgsets/{name}
Returns the configuration details for the specified Path Topology Hiding Configuration Set. If the specified Path Topology Hiding Configuration Set does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/pathtopologyhidingcfgsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pathtopologyhidingcfgset/pathtopologyhidingcfgset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"encryptionKey": {
"description": "Encryption Key will be used for Error-Reporting Host obscuring. Encryption Key must be at most 16-Character alphanumeric String.",
"minLength": 1,
"maxLength": 16,
"pattern": "^([a-zA-Z0-9])+$",
"type": "string"
},
"hostnameSuffix": {
"description": "Hostname Suffixes for this Path Topology Hiding Configuration Set. Hostname Suffix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"name": {
"description": "Name for the Path Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pseudoProxy": {
"description": "Proxy-Host Pseudo Hostname will be used while replacing the host name in the Proxy-Host AVP. Proxy-Host Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoRouteRecord": {
"description": "Route-Record Pseudo Hostname will be used while replacing the Route-Record headers. Route-Record Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"required": [
"encryptionKey",
"hostnameSuffix",
"name",
"pseudoProxy",
"pseudoRouteRecord"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"encryptionKey": "TestEncKey123",
"hostnameSuffix": [
"oracle1.com",
"oracle2.com"
],
"name": "MmiTestPathTopologyHidingCfgSet",
"pseudoProxy": "test.oracle1.com",
"pseudoRouteRecord": "test.oracle2.com"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/pathtopologyhidingcfgsets/{name}
Updates the configuration for the specified Path Topology Hiding Configuration Set. If the provided Path Topology Hiding Configuration Set data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pathtopologyhidingcfgset/pathtopologyhidingcfgset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"encryptionKey": {
"description": "Encryption Key will be used for Error-Reporting Host obscuring. Encryption Key must be at most 16-Character alphanumeric String.",
"minLength": 1,
"maxLength": 16,
"pattern": "^([a-zA-Z0-9])+$",
"type": "string"
},
"hostnameSuffix": {
"description": "Hostname Suffixes for this Path Topology Hiding Configuration Set. Hostname Suffix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 10,
"type": "array"
},
"name": {
"description": "Name for the Path Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pseudoProxy": {
"description": "Proxy-Host Pseudo Hostname will be used while replacing the host name in the Proxy-Host AVP. Proxy-Host Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoRouteRecord": {
"description": "Route-Record Pseudo Hostname will be used while replacing the Route-Record headers. Route-Record Pseudo Hostname is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"required": [
"encryptionKey",
"hostnameSuffix",
"name",
"pseudoProxy",
"pseudoRouteRecord"
],
"type": "object"
}
Example
{
"encryptionKey": "TestEncKey123",
"hostnameSuffix": [
"oracle1.com",
"oracle2.com"
],
"name": "MmiTestPathTopologyHidingCfgSet",
"pseudoProxy": "test.oracle1.com",
"pseudoRouteRecord": "test.oracle2.com"
}
delete /diameter/pathtopologyhidingcfgsets/{name}
Deletes the specified Path Topology Hiding Configuration Set from the NOAM configuration. A Path Topology Hiding Configuration Set data will only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: S9 PCRF Topology Hiding Configuration Sets
S9 PCRF Topology Hiding Configuration Sets provide information that is used to perform S9 PCRF Topology Hiding for a Protected Network PCRFs, as well as the number of PCRFs in the network, when it exchanges messages with Untrusted Networks. A PCRF's identity is embedded in the Origin-Host and Session-ID AVPs sent in Request messages and the Origin-Host AVP sent in Answer messages.
All S9 PCRF Topology Hiding Configuration Set configuration is done at the NOAM.
/diameter/pcrftopologyhidingcfgsets
get /diameter/pcrftopologyhidingcfgsets
Returns all S9 PCRF Topology Hiding Configuration Sets configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those S9 PCRF Topology Hiding Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/pcrftopologyhidingcfgsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pcrftopologyhidingcfgset/pcrftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 PCRF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 PCRF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 600,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 PCRF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 PCRF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestPcrfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/pcrftopologyhidingcfgsets
Adds a new S9 PCRF Topology Hiding Configuration Set to the DSR configuration. The new S9 PCRF Topology Hiding Configuration Set must have a name that is unique to the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pcrftopologyhidingcfgset/pcrftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 PCRF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 PCRF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 600,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 PCRF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 PCRF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestPcrfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/pcrftopologyhidingcfgsets/{name}
get /diameter/pcrftopologyhidingcfgsets/{name}
Returns the configuration details for the specified S9 PCRF Topology Hiding Configuration Set. If the specified S9 PCRF Topology Hiding Configuration Set does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/pcrftopologyhidingcfgsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pcrftopologyhidingcfgset/pcrftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 PCRF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 PCRF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 600,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 PCRF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 PCRF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestPcrfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/pcrftopologyhidingcfgsets/{name}
Updates the configuration for the specified S9 PCRF Topology Hiding Configuration Set. If the provided S9 PCRF Topology Hiding Configuration Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pcrftopologyhidingcfgset/pcrftopologyhidingcfgset.json",
"properties": {
"action": {
"description": "Action to be performed when the Orig-Host in the Diameter message is not configured as Actual Hostname in this S9 PCRF Topology Hiding Configuration Set. Default value is SendAnswer.",
"enum": [
"SendAnswer",
"Abandon",
"Forward"
],
"default": "SendAnswer",
"type": "string"
},
"autoGenerate": {
"description": "When set to true, Pseudo Hostnames are automatically generated corresponding to an Actual Hostname. When set to false, Pseudo Hostnames are not automatically generated, rather to be provided manually. Moreover, prefix and suffix values need not to be provided as part of pseudo hostname generation in case of false value.",
"default": true,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"count": {
"description": "It specifies the maximum number of Pseudo Hostnames associated with an Actual Hostname. It ranges from 1 to 3 and default value is 3.",
"minimum": 1,
"maximum": 3,
"default": 3,
"type": "integer"
},
"errMsg": {
"description": "This is the string to be placed in the Error-Message AVP of the Answer message.",
"minLength": 0,
"maxLength": 64,
"type": "string"
},
"hostnames": {
"description": "List of Actual Hostnames and their Pseudo Hostnames in underlying S9 PCRF Topology Hiding Configuration Set.",
"items": {
"properties": {
"actualHostname": {
"description": "Actual Hostname is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Actual Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname1": {
"description": "Pseudo Hostname 1 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname2": {
"description": "Pseudo Hostname 2 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"pseudoHostname3": {
"description": "Pseudo Hostname 3 is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and Pseudo Hostname must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
}
},
"type": "object"
},
"minItems": 1,
"maxItems": 600,
"type": "array"
},
"length": {
"description": "Length of the random number used in the auto generated Pseudo Hostname.",
"minLength": 4,
"maxLength": 5,
"default": 4,
"type": "integer"
},
"name": {
"description": "Name for the S9 PCRF Topology Hiding Configuration Set, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"prefix": {
"description": "This is Prefix for the auto generated Pseudo Hostname. Prefix is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Prefix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"randomizeCount": {
"description": "When set to true, random number of Pseudo Hostnames between 1 and Count are associated with an Actual Hostname. When set to false, exactly Count number of Pseudo Hostnames are associated with an Actual Hostname.",
"default": true,
"type": "boolean"
},
"resultCode": {
"description": "Value to be placed in the Result-Code AVP of the Answer message. S9 PCRF Actual Hostname Not Found Answer Result-Code Value is required if action is 'Send Answer'.",
"minLength": 1000,
"maxLength": 5999,
"default": 3002,
"type": "integer"
},
"suffix": {
"description": "Suffix for the auto generated Pseudo Hostname. Suffix is case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. Suffix must be at most 63 characters long.",
"minLength": 1,
"maxLength": 63,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"vendorId": {
"description": "Vendor Id will be placed in Vendor Id AVP.",
"minLength": 1,
"maxLength": 4294967295,
"type": "integer"
}
},
"required": [
"hostnames",
"name"
],
"type": "object"
}
Example
{
"action": "SendAnswer",
"autoGenerate": true,
"count": 3,
"hostnames": [
{
"actualHostname": "test1.oracle.com",
"pseudoHostname1": "preTest.2441.postTest",
"pseudoHostname2": "preTest.9741.postTest",
"pseudoHostname3": "preTest.2975.postTest"
},
{
"actualHostname": "test2.oracle.com",
"pseudoHostname1": "preTest.2906.postTest",
"pseudoHostname2": "preTest.2006.postTest"
},
{
"actualHostname": "test3.oracle.com",
"pseudoHostname1": "preTest.9720.postTest"
}
],
"length": 4,
"name": "MmiTestPcrfTopologyHidingCfgSet",
"prefix": "preTest",
"randomizeCount": true,
"resultCode": 3002,
"suffix": "postTest",
"vendorId": 1001
}
delete /diameter/pcrftopologyhidingcfgsets/{name}
Deletes the specified S9 PCRF Topology Hiding Configuration Set from the NOAM configuration. An S9 PCRF Topology Hiding Configuration Set can only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Peer DA-MP Connectivity Status
The Peer DA-MP Connectivity Status Table displays the information about connections on the DA-MPs.
/diameter/peerdampconnectivity/status
get /diameter/peerdampconnectivity/status
Returns the status of all Peer DA-MP Connectivities that meet the criteria specified in the request.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peerdampconnectivitystatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerdampconnectivitystatus/peerdampconnectivitystatus.json",
"properties": {
"currentTotalConnMaxIngressMPS": {
"description": "The sum of the Maximum Ingress MPS settings for all fixed and floating IPFE connections currently established on the DA-MP.",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"freeConnectionCapacity": {
"description": "The free connection capacity subtracts the used value from the max connections value in the MP profile of the reported DA-MP.",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"freeReservedMPSCapacity": {
"description": "The free reserved MPS capacity subtracts the used value from the engineered ingress message rate value of the DA-MP in the MP Profile.",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"numFixedConnsConfigured": {
"description": "The number of configured Connections whose IP Address is one of the fixed IP addresses assigned to the DA-MP.",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"numFixedConnsEstablished": {
"description": "The number of Connections whose operation status is available and IP Address is one of the fixed IP addresses assigned to the DA-MP.",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"numFloatConnsConfigured": {
"description": "The number of configured floating IPFE connections on a DA-MP in the TSA(s).",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"numFloatConnsEstablished": {
"description": "The number of floating IPFE connections owned by the DA-MP whose operation status is available.",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"serverHostname": {
"description": "The hostname of the reporting DA-MP server.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Peer DAMP Connectivity record are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Peer DAMP Connectivity record. If the OAM has current status for this Peer DAMP Connectivity record, statusKnown is set to true.",
"readOnly": true,
"type": "boolean"
},
"usedConnectionCapacity": {
"description": "The used connection capacity sums the number of fixed connections configured and the number of floating IPFE connections established.",
"readOnly": true,
"minimum": 0,
"type": "integer"
},
"usedReservedMPSCapacity": {
"description": "The used reserved MPS capacity sums the reserved ingress MPS capacity set in the capacity configuration sets table for all fixed connections configured for the DA-MP and all floating IPFE connection currently established on the DA-MP.",
"readOnly": true,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"currentTotalConnMaxIngressMPS": 70000,
"freeConnectionCapacity": 993,
"freeReservedMPSCapacity": 10000,
"numFixedConnsConfigured": 7,
"numFixedConnsEstablished": 0,
"numFloatConnsConfigured": 0,
"numFloatConnsEstablished": 0,
"serverHostname": "MP1",
"statusKnown": true,
"usedConnectionCapacity": 7,
"usedReservedMPSCapacity": 0
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Diameter: Peer DA-MP Status
The Peer DA-MP Status Table displays the peer status information for the DA-MPs.
/diameter/peerdamps/status
get /diameter/peerdamps/status
Returns the status of all Peer DA-MPs that meet the criteria specified in the request.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peerdampstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerdampstatus/peerdampstatus.json",
"properties": {
"mpLeader": {
"description": "Indicates whether a DA-MP reports itself as MP Leader. The MP Leader provides status information to the OAM for Route Lists, Route Groups and Peer Nodes which are resources whose scope is beyond a single DA-MP.",
"type": "boolean"
},
"numPeerMpsAvailable": {
"description": "The number of peer DA-MPs whose status is available.",
"maximum": 64,
"minimum": 0,
"type": "integer"
},
"numPeerMpsDegraded": {
"description": "The number of peer DA-MPs whose status is degraded.",
"maximum": 64,
"minimum": 0,
"type": "integer"
},
"numPeerMpsUnavailable": {
"description": "The number of peer DA-MPs whose status is unavailable.",
"maximum": 64,
"minimum": 0,
"type": "integer"
},
"serverHostname": {
"description": "The hostname of the reporting DA-MP server.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Peer DAMP record are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Peer DAMP record. If the OAM has current status for this Peer DAMP record, statusKnown is set to true.",
"type": "boolean"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"mpLeader": true,
"numPeerMpsAvailable": 2,
"numPeerMpsDegraded": 0,
"numPeerMpsUnavailable": 1,
"serverHostname": "MP1",
"statusKnown": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Diameter: Peer Node Alarm Groups
Peer Node Alarm Group is group of peernodes (/diameter/peernodes) and each group is having throttle and abatement threshold values in % for minor, major and critical severity. Peer Node Alarm Group is used by alarm group feature, if alarm group feature is enabled through Options (/diameter/options).
All Peer Node Alarm Group configuration is done at the SOAM.
/diameter/peernodealarmgroups
get /diameter/peernodealarmgroups
Returns all Peer Node Alarm Groups configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Peer Node Alarm Groups meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peernodealarmgroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodealarmgroup/peernodealarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Peer Node Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold.. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"peerNodeName": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Alarm Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"peerNodeName",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"name": "peerNodeGroup1",
"peerNodeName": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
],
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/peernodealarmgroups
Adds a new Peer Node Alarm Group to the DSR configuration. The new Peer Node Alarm Group must have a name unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodealarmgroup/peernodealarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Peer Node Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold.. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"peerNodeName": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Alarm Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"peerNodeName",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold"
],
"type": "object"
}
Example
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"name": "peerNodeGroup1",
"peerNodeName": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
],
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/peernodealarmgroups/{name}
get /diameter/peernodealarmgroups/{name}
Returns the configuration details for the specified Peer Node Alarm Group. If the specified Peer Node Alarm Group does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/peernodealarmgroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodealarmgroup/peernodealarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Peer Node Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold.. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"peerNodeName": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Alarm Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"peerNodeName",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"name": "peerNodeGroup1",
"peerNodeName": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
],
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/peernodealarmgroups/{name}
Updates the configuration for the specified Peer Node Alarm Group. If the provided Peer Node Alarm Group data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodealarmgroup/peernodealarmgroup.json",
"properties": {
"abatementCriticalThreshold": {
"description": "(%). Abatement Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the critical abatement level, critical threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Critical Threshold > Throttle and Abatement Minor Threshold. Abatement Critical Threshold > Throttle and Abatement Major Threshold. Abatement Critical Threshold < Throttle Critical Threshold.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"abatementMajorThreshold": {
"description": "(%). Abatement Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the major abatement level, major threshold alarm is cleared. Following constraints shall be applied on the value: Abatement Major Threshold > Throttle and Abatement Minor Threshold. Abatement Major Threshold < Throttle Major Threshold. Abatement Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 97,
"minimum": 3,
"type": "integer"
},
"abatementMinorThreshold": {
"description": "(%). Abatement Minor Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers falls under the minor abatement level, minor threshold alarm is cleared. Following constraints shall be applied on the value:Abatement Minor Threshold < Throttle Minor Threshold. Abatement Minor Threshold < Throttle and Abatement Major Threshold. Abatement Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 95,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for the Peer Node Alarm Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Alarm Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"throttleCriticalThreshold": {
"description": "(%). Throttle Critical Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the critical throttle level, critical threshold alarm is raised. Following constraints shall be applied on the value: Throttle Critical Threshold > Throttle and Abatement Minor Threshold. Throttle Critical Threshold > Throttle and Abatement Major Threshold. Throttle Critical Threshold > Abatement Critical Threshold.",
"maximum": 100,
"minimum": 6,
"type": "integer"
},
"throttleMajorThreshold": {
"description": "(%). Throttle Major Threshold. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the major throttle level, major threshold alarm is raised. Following constraints shall be applied on the value: Throttle Major Threshold > Throttle and Abatement Minor Threshold. Throttle Major Threshold > Abatement Major Threshold. Throttle Major Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 98,
"minimum": 4,
"type": "integer"
},
"throttleMinorThreshold": {
"description": "(%). Throttle Minor Threshold.. This % value indicates the number of peers failed out of total number of peers configured for that Peer Node Alarm Group. When the count of failed peers reaches the minor throttle level, minor threshold alarm is raised. Following constraints shall be applied on the value: Throttle Minor Threshold > Abatement Minor Threshold. Throttle Minor Threshold < Throttle and Abatement Major Threshold. Throttle Minor Threshold < Throttle and Abatement Critical Threshold.",
"maximum": 96,
"minimum": 2,
"type": "integer"
},
"peerNodeName": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Alarm Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 1,
"maxItems": 200,
"type": "array"
}
},
"required": [
"abatementCriticalThreshold",
"abatementMajorThreshold",
"abatementMinorThreshold",
"name",
"peerNodeName",
"throttleCriticalThreshold",
"throttleMajorThreshold",
"throttleMinorThreshold"
],
"type": "object"
}
Example
{
"abatementCriticalThreshold": 5,
"abatementMajorThreshold": 3,
"abatementMinorThreshold": 1,
"name": "peerNodeGroup1",
"peerNodeName": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
],
"throttleCriticalThreshold": 6,
"throttleMajorThreshold": 4,
"throttleMinorThreshold": 2
}
delete /diameter/peernodealarmgroups/{name}
Deletes the specified Peer Node Alarm Group from the SOAM configuration. A Peer Node Alarm Group is only deleted if all delete validation checks pass. There is no reference check for Peer Node Alarm Group.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Peer Node Groups
A Peer Node Group is a customer-defined set of Peer Nodes (/diameter/peernodegroups) whose Connections (/diameter/connections) (for reasons of redundancy) should not all be owned by the same DA-MP within a single IPFE Target Set (/diameter/ipfetargetsets). The IPFE detects a subsequent Connection is from within the same Peer Node Group and avoids passing that Connection to the same DA-MP. For example, if the Peer Node Group Distribution Threshold (/diameter/ipfetargetsets) has a value of two, then the IPFE avoids assigning more than two Connections to the same DA-MP within an IPFE Target Set.
All Peer Node Group configuration is done at the SOAM.
/diameter/peernodegroups
get /diameter/peernodegroups
Returns all Peer Node Groups configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Peer Node Groups meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peernodegroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodegroup/peernodegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Peer Node Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 0,
"maxItems": 32,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "123",
"name": "peerNodeGroup1",
"peerNode": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/peernodegroups
Adds a new Peer Node Group to the DSR configuration. The new Peer Node Group must have a name unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodegroup/peernodegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Peer Node Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 0,
"maxItems": 32,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "123",
"name": "peerNodeGroup1",
"peerNode": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/peernodegroups/{name}
get /diameter/peernodegroups/{name}
Returns the configuration details for the specified Peer Node Group. If the specified Peer Node Group does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/peernodegroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodegroup/peernodegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Peer Node Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 0,
"maxItems": 32,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "123",
"name": "peerNodeGroup1",
"peerNode": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/peernodegroups/{name}
Updates the configuration for the specified Peer Node Group. If the provided Peer Node Group data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernodegroup/peernodegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Peer Node Group, which must be unique within the DSR site. A name is required and cannot be changed after the Peer Node Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "List of Peer Nodes (/diameter/peernodes) that are part of this Peer Node Group.",
"items": {
"description": "Name of a Peer Node (/diameter/peernodes). Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"minItems": 0,
"maxItems": 32,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "123",
"name": "peerNodeGroup1",
"peerNode": [
"PeerNode1",
"PeerNode2",
"PeerNode3"
]
}
delete /diameter/peernodegroups/{name}
Deletes the specified Peer Node Group from the SOAM configuration. A Peer Node Group is only deleted if all delete validation checks pass. If the Peer Node Group is part of the configuration of some other Managed Object, the Peer Node Group cannot be deleted. For example, if the Peer Node Group is associated with a Peer Node, that association must first be removed (either by editing the Peer Node and choosing a different Peer Node Group, or deleting the Peer Node entirely). Then the Peer Node Group can be deleted from the configuration. An attempt to delete a Peer Node Group that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Peer Nodes
A Peer Node is the DSR's logical representation of a remote node, accessible over one or more transport connections, with which the DSR can transact Diameter or RADIUS messages. The Peer Node managed object encapsulates all the characteristics of the remote node that the DSR must know about in order to communicate successfully with it.
All Peer Node configuration is done at the SOAM.
/diameter/peernodes
get /diameter/peernodes
Returns all Peer Nodes configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Peer Nodes meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Peer Nodes.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peernodeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernode/peernode.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Peer Node, which defines the Peer Node as either Diameter or Radius. This value is required for all Peer Nodes, and cannot be changed after the Peer Node is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"altRouteName": {
"description": "Route List (/diameter/routelists) to use for routing messages if implicit routing was used to route to this Peer Node and was unsuccessful.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"altRtOnAnswerResultCode": {
"description": "When a Reroute on Answer result code is received, this property defines whether alternate routing is attempted on any alternate Connections (/diameter/connections) to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"altRtOnAnswerTimeout": {
"description": "When an answer timeout occurs, this property defines whether alternate routing is attempted on the same Connection (/diameter/connections); on an alternate Connection to the same Peer Node; or whether the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups) is selected. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer",
"SameConnection"
],
"type": "string"
},
"altRtOnConnFailure": {
"description": "When a Connection (/diameter/connections) failure occurs, if this property is set to SamePeer, routing is attempted on any alternate Connections to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"answerOnAnyEnabledConnection": {
"description": "If true, means the answer can be received on any enabled Connection (/diameter/connections) to this Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"appRouteTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"avpRemovalListName": {
"description": "Name of the AVP Removal List (/diameter/avpremovallists) associated with this Peer Node. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for DTLS/SCTP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ignorePriorityFromPeer": {
"description": "If true, indicates DSR avoid the message priority assignment using DRMP and NGN-PS AVPs from ingress message for a given Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"ip": {
"description": "The IP address list of this Peer Node. Between zero and 128 (inclusive) IP addresses can be defined for a Peer Node. Each value provided must be a valid IPv4 or IPv6 address.",
"items": {
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"isDynamic": {
"description": "If true, means the Peer Node was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Peer Nodes only.",
"readOnly": true,
"type": "boolean"
},
"maxAltRouteAttempts": {
"description": "The maximum number of times that a Request can be rerouted to this Peer Node before the next eligible Peer Node is selected.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"minConnCapacity": {
"description": "The minimum number of available Connections (/diameter/connections) to the Peer Node in order for it to be Available. Otherwise, if the number of available Connections to the Peer Node is less than minConnCapacity, the Peer Node is considered Degraded. Similarly, if no Connections are available to the Peer Node, it is considered Unavailable.",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Peer Node supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when msgPrioritySetting is UserConfigured. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a request message and the receiving Connection's (/diameter/connections) msgPrioritySetting (Message Priority Setting) is set to None, the Message Priority Setting determines how priority is assigned to the Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to None, the Default Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) is used. When set to UserConfigured, the Message Priority Configuration Set assigned to this Peer Node is used to determine the priority of request messages received from the Peer Node. Diameter Peer Nodes only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"name": {
"description": "Name for the Peer Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeGroupName": {
"description": "Name of the Peer Node Group (/diameter/peernodegroups) to which this Peer Node is assigned.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimers) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Peer Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"replaceDestHost": {
"description": "If set to true, indicates the Destination-Host AVP of outgoing messages should be overwritten with this Peer Node's Fully Qualified Domain Name. Diameter Peer Nodes only.",
"type": "boolean"
},
"replaceDestRealm": {
"description": "If set to true, indicates that the Destination-Realm AVP of outgoing messages should be overwritten with this Peer Node's Realm. Diameter Peer Nodes only.",
"type": "boolean"
},
"routingOptionSetName": {
"description": "Name of the Routing Option Set (/diameter/routingoptionsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for SCTP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port(s) that serve(s) as the destination port(s) for messages from the DSR to this Peer Node, which represents a RADIUS Server. Between one and ten (inclusive) UDP server ports must be specified for a RADIUS Peer Node. RADIUS Peer Nodes only.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"tcpPort": {
"description": "TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TCP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TLS/TCP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"topologyHidingEnabled": {
"description": "If true, indicates Topology Hiding is applicable to this Peer Node. Diameter Peer Nodes only.",
"type": "boolean"
},
"transactionCfgSetName": {
"description": "Name of the Transaction Configuration Set (/diameter/transactionconfigurationsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"aaaProtocol",
"fqdn",
"maxAltRouteAttempts",
"minConnCapacity",
"name",
"realm"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"aaaProtocol": "Diameter",
"altRtOnAnswerResultCode": "DifferentPeer",
"altRtOnAnswerTimeout": "DifferentPeer",
"altRtOnConnFailure": "DifferentPeer",
"answerOnAnyEnabledConnection": false,
"fqdn": "PeerNode3.realm1.com",
"ignorePriorityFromPeer": false,
"ip": [
"172.016.001.004",
"fe80:0000:0000:0000:0200:f8ff:fe21:67cf"
],
"isDynamic": false,
"maxAltRouteAttempts": 4,
"minConnCapacity": 1,
"msgPriorityCfgSet": "Default",
"msgPrioritySetting": "None",
"name": "PeerNode4",
"realm": "realm1.com",
"replaceDestHost": false,
"replaceDestRealm": false,
"sctpPort": 1059,
"tcpPort": 1699,
"topologyHidingEnabled": false
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/peernodes
Adds a new Peer Node to the DSR configuration. The new Peer Node must have a name that is unique across all Peer Nodes at the SOAM. In addition, the Peer Node's FQDN must also be unique across all Peer Nodes configured at the SOAM. If the AAA Protocol for the Peer Node is Diameter, no attributes that are unique to RADIUS should be present in the request. Likewise, if the AAA Protocol is RADIUS, no attributes that are unique to Diameter should be present in the request.
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Peer Nodes.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernode/peernode.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Peer Node, which defines the Peer Node as either Diameter or Radius. This value is required for all Peer Nodes, and cannot be changed after the Peer Node is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"altRouteName": {
"description": "Route List (/diameter/routelists) to use for routing messages if implicit routing was used to route to this Peer Node and was unsuccessful.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"altRtOnAnswerResultCode": {
"description": "When a Reroute on Answer result code is received, this property defines whether alternate routing is attempted on any alternate Connections (/diameter/connections) to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"altRtOnAnswerTimeout": {
"description": "When an answer timeout occurs, this property defines whether alternate routing is attempted on the same Connection (/diameter/connections); on an alternate Connection to the same Peer Node; or whether the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups) is selected. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer",
"SameConnection"
],
"type": "string"
},
"altRtOnConnFailure": {
"description": "When a Connection (/diameter/connections) failure occurs, if this property is set to SamePeer, routing is attempted on any alternate Connections to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"answerOnAnyEnabledConnection": {
"description": "If true, means the answer can be received on any enabled Connection (/diameter/connections) to this Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"appRouteTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"avpRemovalListName": {
"description": "Name of the AVP Removal List (/diameter/avpremovallists) associated with this Peer Node. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for DTLS/SCTP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ignorePriorityFromPeer": {
"description": "If true, indicates DSR avoid the message priority assignment using DRMP and NGN-PS AVPs from ingress message for a given Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"ip": {
"description": "The IP address list of this Peer Node. Between zero and 128 (inclusive) IP addresses can be defined for a Peer Node. Each value provided must be a valid IPv4 or IPv6 address.",
"items": {
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"isDynamic": {
"description": "If true, means the Peer Node was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Peer Nodes only.",
"readOnly": true,
"type": "boolean"
},
"maxAltRouteAttempts": {
"description": "The maximum number of times that a Request can be rerouted to this Peer Node before the next eligible Peer Node is selected.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"minConnCapacity": {
"description": "The minimum number of available Connections (/diameter/connections) to the Peer Node in order for it to be Available. Otherwise, if the number of available Connections to the Peer Node is less than minConnCapacity, the Peer Node is considered Degraded. Similarly, if no Connections are available to the Peer Node, it is considered Unavailable.",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Peer Node supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when msgPrioritySetting is UserConfigured. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a request message and the receiving Connection's (/diameter/connections) msgPrioritySetting (Message Priority Setting) is set to None, the Message Priority Setting determines how priority is assigned to the Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to None, the Default Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) is used. When set to UserConfigured, the Message Priority Configuration Set assigned to this Peer Node is used to determine the priority of request messages received from the Peer Node. Diameter Peer Nodes only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"name": {
"description": "Name for the Peer Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeGroupName": {
"description": "Name of the Peer Node Group (/diameter/peernodegroups) to which this Peer Node is assigned.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimers) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Peer Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"replaceDestHost": {
"description": "If set to true, indicates the Destination-Host AVP of outgoing messages should be overwritten with this Peer Node's Fully Qualified Domain Name. Diameter Peer Nodes only.",
"type": "boolean"
},
"replaceDestRealm": {
"description": "If set to true, indicates that the Destination-Realm AVP of outgoing messages should be overwritten with this Peer Node's Realm. Diameter Peer Nodes only.",
"type": "boolean"
},
"routingOptionSetName": {
"description": "Name of the Routing Option Set (/diameter/routingoptionsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for SCTP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port(s) that serve(s) as the destination port(s) for messages from the DSR to this Peer Node, which represents a RADIUS Server. Between one and ten (inclusive) UDP server ports must be specified for a RADIUS Peer Node. RADIUS Peer Nodes only.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"tcpPort": {
"description": "TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TCP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TLS/TCP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"topologyHidingEnabled": {
"description": "If true, indicates Topology Hiding is applicable to this Peer Node. Diameter Peer Nodes only.",
"type": "boolean"
},
"transactionCfgSetName": {
"description": "Name of the Transaction Configuration Set (/diameter/transactionconfigurationsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"aaaProtocol",
"fqdn",
"maxAltRouteAttempts",
"minConnCapacity",
"name",
"realm"
],
"type": "object"
}
Example
{
"aaaProtocol": "Diameter",
"altRtOnAnswerResultCode": "DifferentPeer",
"altRtOnAnswerTimeout": "DifferentPeer",
"altRtOnConnFailure": "DifferentPeer",
"answerOnAnyEnabledConnection": false,
"fqdn": "PeerNode3.realm1.com",
"ignorePriorityFromPeer": false,
"ip": [
"172.016.001.004",
"fe80:0000:0000:0000:0200:f8ff:fe21:67cf"
],
"isDynamic": false,
"maxAltRouteAttempts": 4,
"minConnCapacity": 1,
"msgPriorityCfgSet": "Default",
"msgPrioritySetting": "None",
"name": "PeerNode4",
"realm": "realm1.com",
"replaceDestHost": false,
"replaceDestRealm": false,
"sctpPort": 1059,
"tcpPort": 1699,
"topologyHidingEnabled": false
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/peernodes/status
get /diameter/peernodes/status
Returns the status of all Peer Nodes that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings can be filtered using only EQUAL. The name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE, while the Time of Last Update can be filtered using only EQUAL or NOT_EQUAL. Peer Node Alarm Group can be filtered using EQUAL, NOT_EQUAL, or LIKE. Alarm Ids can be filtered using LIKE.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
Returns the status of all Peer Nodes that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings can be filtered using only EQUAL. The peer node name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE, while the Time of Last Update can be filtered using only EQUAL or NOT_EQUAL. Peer Node Alarm Group can be filtered using EQUAL, NOT_EQUAL, or LIKE. Alarm Ids can be filtered using LIKE.
Example:
filter_name=peerNodeName
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=Enabled
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peernodestatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernode/peernodestatus.json",
"properties": {
"connection": {
"description": "The list of details of Connections (/diameter/connections) associated with a peer node. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties":{
"connectionAlarmGroupName": {
"description": "A name given to a group of Connections (/diameter/connectionalarmgroups). Connection Alarm Group is used by Alarm Group feature if it is enabled. The feature can be enabled through Options (/diameter/options). This parameter will be present in the status data only if Alarm Group feature is enabled and Connection Alarm Group is created.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"connectionAlarmIds": {
"description": "Alarm Id raised for the connection by the DAMP. This parameter will be present in the status data only if Alarm Group feature is enabled through Options (/diameter/options).",
"readOnly": true,
"type": "array"
},
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"connectionOperationalReason": {
"description": "Reason for the connection Operational Status. Information is also available for each connection.",
"maxLength": 32,
"readOnly": true,
"type": "string"
},
"connectionOperationalStatus": {
"description": "Tells connection operational status. When Available is specified, at least one Peer Node connection is available for routing. When Degraded is specified, the Peer Node connection is not unavailable but it is not operating as expected. When Unavailable is specified all connections for a Peer Node are unavailable. The Operational Reason field provides additional information Degraded and Unavailable status.",
"enum": [
"Available",
"Degraded",
"Unavailable"
],
"readOnly": true,
"type": "string"
},
"connectionTimeOfLastUpdate": {
"description": "The date/time the status for this specific connection of Peer Node Table was last updated by the DSR.",
"readOnly": true,
"type": "string"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For the Peer Node status:In case of Multiple Active DA-MP configuration, the MP Leader always reports the Peer Node status and in case of Active/Standby DA-MP configuration, the Active DA-MP reports the Peer Node status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Peer Node was created dynamically as a result of dynamic peer discovery.",
"readOnly": true,
"type": "boolean"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For the Peer Node status:In case of Multiple Active DA-MP configuration, the MP Leader always reports the Peer Node status and in case of Active/Standby DA-MP configuration, the Active DA-MP reports the Peer Node status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
},
"peerNodeAlarmGroupName": {
"description": "A name given to a group of Peer Nodes (/diameter/peernodealarmgroups). Peer Node Alarm Group is used by Alarm Group feature if it is enabled. The feature can be enabled through Options (/diameter/options). This parameter will be present in the status data only if Alarm Group feature is enabled and Peer Node Alarm Group is created.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNodeAlarmIds": {
"description": "Alarm Id raised for the peer by the DAMP. This parameter will be present in the status data only if Alarm Group feature is enabled through Options (/diameter/options).",
"readOnly": true,
"type": "array"
},
"peerNodeGrpName": {
"description": "Name of the Peer Node Group (/diameter/peernodegroups) to which this Peer Node is assigned.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNodeName": {
"description": "This peernode name is the name configured through /diameter/peernodes, which must be unique within the DSR site. A name is required, and cannot be changed after the Peer Node is initially configured.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerOperationalReason": {
"description": "Reason for the Peer Node Operational Status. Information is also available for each connection.",
"maxLength": 32,
"readOnly": true,
"type": "string"
},
"peerOperationalStatus": {
"description": "Tells peer node operational status. When Available is specified, at least one Peer Node connection is available for routing. When Degraded is specified, the Peer Node connection is not unavailable but it is not operating as expected. When Unavailable is specified all connections for a Peer Node are unavailable. The Operational Reason field provides additional information Degraded and Unavailable status.",
"enum": [
"Available",
"Degraded",
"Unavailable"
],
"readOnly": true,
"type": "string"
},
"peerTimeOfLastUpdate": {
"description": "The date/time the status for this specific peer of Peer Node Table was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"readOnly": true,
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection/Peer Status are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection/Peer. If the OAM has current status for this Connection Status, statusKnown is set to true.",
"type": "boolean"
},
"transactionCfgSetName": {
"description": "Name of the Transaction Configuration Set (/diameter/transactionconfigurationsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"connection": [
{
"connectionAlarmIds": [
"22308",
"22307"
],
"mpServerHostName": "MP1",
"connectionAlarmGroupName": "connectionalarmgroup1",
"connectionName": "hss",
"connectionOperationalReason": "Disabled",
"connectionOperationalStatus": "Available",
"connectionTimeOfLastUpdate": "2018-Mar-05 11:05:05 EDT"
}
],
"isDynamic": false,
"mpServerHostName": "MP1",
"peerNodeAlarmIds": [
"22308",
"22307"
],
"peerNodeAlarmGroupName": "peernodealarmgroup1",
"peerNodeName": "hss",
"peerOperationalReason": "Normal",
"peerOperationalStatus": "Available",
"peerTimeOfLastUpdate": "2018-Feb-21 11:05:05 EDT",
"statusKnown": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/peernodes/{name}
get /diameter/peernodes/{name}
Returns the configuration details for the specified Peer Node. If the specified Peer Node does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Peer Nodes.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/peernodeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernode/peernode.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Peer Node, which defines the Peer Node as either Diameter or Radius. This value is required for all Peer Nodes, and cannot be changed after the Peer Node is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"altRouteName": {
"description": "Route List (/diameter/routelists) to use for routing messages if implicit routing was used to route to this Peer Node and was unsuccessful.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"altRtOnAnswerResultCode": {
"description": "When a Reroute on Answer result code is received, this property defines whether alternate routing is attempted on any alternate Connections (/diameter/connections) to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"altRtOnAnswerTimeout": {
"description": "When an answer timeout occurs, this property defines whether alternate routing is attempted on the same Connection (/diameter/connections); on an alternate Connection to the same Peer Node; or whether the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups) is selected. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer",
"SameConnection"
],
"type": "string"
},
"altRtOnConnFailure": {
"description": "When a Connection (/diameter/connections) failure occurs, if this property is set to SamePeer, routing is attempted on any alternate Connections to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"answerOnAnyEnabledConnection": {
"description": "If true, means the answer can be received on any enabled Connection (/diameter/connections) to this Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"appRouteTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"avpRemovalListName": {
"description": "Name of the AVP Removal List (/diameter/avpremovallists) associated with this Peer Node. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for DTLS/SCTP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ignorePriorityFromPeer": {
"description": "If true, indicates DSR avoid the message priority assignment using DRMP and NGN-PS AVPs from ingress message for a given Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"ip": {
"description": "The IP address list of this Peer Node. Between zero and 128 (inclusive) IP addresses can be defined for a Peer Node. Each value provided must be a valid IPv4 or IPv6 address.",
"items": {
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"isDynamic": {
"description": "If true, means the Peer Node was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Peer Nodes only.",
"readOnly": true,
"type": "boolean"
},
"maxAltRouteAttempts": {
"description": "The maximum number of times that a Request can be rerouted to this Peer Node before the next eligible Peer Node is selected.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"minConnCapacity": {
"description": "The minimum number of available Connections (/diameter/connections) to the Peer Node in order for it to be Available. Otherwise, if the number of available Connections to the Peer Node is less than minConnCapacity, the Peer Node is considered Degraded. Similarly, if no Connections are available to the Peer Node, it is considered Unavailable.",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Peer Node supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when msgPrioritySetting is UserConfigured. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a request message and the receiving Connection's (/diameter/connections) msgPrioritySetting (Message Priority Setting) is set to None, the Message Priority Setting determines how priority is assigned to the Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to None, the Default Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) is used. When set to UserConfigured, the Message Priority Configuration Set assigned to this Peer Node is used to determine the priority of request messages received from the Peer Node. Diameter Peer Nodes only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"name": {
"description": "Name for the Peer Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeGroupName": {
"description": "Name of the Peer Node Group (/diameter/peernodegroups) to which this Peer Node is assigned.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimers) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Peer Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"replaceDestHost": {
"description": "If set to true, indicates the Destination-Host AVP of outgoing messages should be overwritten with this Peer Node's Fully Qualified Domain Name. Diameter Peer Nodes only.",
"type": "boolean"
},
"replaceDestRealm": {
"description": "If set to true, indicates that the Destination-Realm AVP of outgoing messages should be overwritten with this Peer Node's Realm. Diameter Peer Nodes only.",
"type": "boolean"
},
"routingOptionSetName": {
"description": "Name of the Routing Option Set (/diameter/routingoptionsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for SCTP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port(s) that serve(s) as the destination port(s) for messages from the DSR to this Peer Node, which represents a RADIUS Server. Between one and ten (inclusive) UDP server ports must be specified for a RADIUS Peer Node. RADIUS Peer Nodes only.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"tcpPort": {
"description": "TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TCP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TLS/TCP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"topologyHidingEnabled": {
"description": "If true, indicates Topology Hiding is applicable to this Peer Node. Diameter Peer Nodes only.",
"type": "boolean"
},
"transactionCfgSetName": {
"description": "Name of the Transaction Configuration Set (/diameter/transactionconfigurationsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"aaaProtocol",
"fqdn",
"maxAltRouteAttempts",
"minConnCapacity",
"name",
"realm"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"aaaProtocol": "Diameter",
"altRtOnAnswerResultCode": "DifferentPeer",
"altRtOnAnswerTimeout": "DifferentPeer",
"altRtOnConnFailure": "DifferentPeer",
"answerOnAnyEnabledConnection": false,
"fqdn": "PeerNode3.realm1.com",
"ignorePriorityFromPeer": false,
"ip": [
"172.016.001.004",
"fe80:0000:0000:0000:0200:f8ff:fe21:67cf"
],
"isDynamic": false,
"maxAltRouteAttempts": 4,
"minConnCapacity": 1,
"msgPriorityCfgSet": "Default",
"msgPrioritySetting": "None",
"name": "PeerNode4",
"realm": "realm1.com",
"replaceDestHost": false,
"replaceDestRealm": false,
"sctpPort": 1059,
"tcpPort": 1699,
"topologyHidingEnabled": false
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/peernodes/{name}
Updates the configuration for the specified Peer Node. If the provided Peer Node data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
If a property is not explicitly identified as Diameter-only or RADIUS-only, it applies to both Diameter and RADIUS Peer Nodes.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernode/peernode.json",
"properties": {
"aaaProtocol": {
"description": "The AAA protocol for this Peer Node, which defines the Peer Node as either Diameter or Radius. This value is required for all Peer Nodes, and cannot be changed after the Peer Node is initially configured.",
"enum": [
"Diameter",
"Radius"
],
"type": "string"
},
"altRouteName": {
"description": "Route List (/diameter/routelists) to use for routing messages if implicit routing was used to route to this Peer Node and was unsuccessful.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"altRtOnAnswerResultCode": {
"description": "When a Reroute on Answer result code is received, this property defines whether alternate routing is attempted on any alternate Connections (/diameter/connections) to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"altRtOnAnswerTimeout": {
"description": "When an answer timeout occurs, this property defines whether alternate routing is attempted on the same Connection (/diameter/connections); on an alternate Connection to the same Peer Node; or whether the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups) is selected. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer",
"SameConnection"
],
"type": "string"
},
"altRtOnConnFailure": {
"description": "When a Connection (/diameter/connections) failure occurs, if this property is set to SamePeer, routing is attempted on any alternate Connections to this Peer Node before selecting the next eligible Peer Node within a Peer Route Group (/diameter/peerroutegroups). If this property is set to DifferentPeer, no attempt is made to try alternate Connections to this Peer Node; the next eligible Peer Node within a Peer Route Group is instead attempted. Diameter Peer Nodes only.",
"enum": [
"DifferentPeer",
"SamePeer"
],
"type": "string"
},
"answerOnAnyEnabledConnection": {
"description": "If true, means the answer can be received on any enabled Connection (/diameter/connections) to this Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"appRouteTableName": {
"description": "Name of the Application Route Table (/diameter/applicationroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"avpRemovalListName": {
"description": "Name of the AVP Removal List (/diameter/avpremovallists) associated with this Peer Node. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"dtlsPort": {
"description": "DTLS/SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for DTLS/SCTP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"ignorePriorityFromPeer": {
"description": "If true, indicates DSR avoid the message priority assignment using DRMP and NGN-PS AVPs from ingress message for a given Peer Node. Typical value is false. Diameter Peer Nodes only.",
"type": "boolean"
},
"ip": {
"description": "The IP address list of this Peer Node. Between zero and 128 (inclusive) IP addresses can be defined for a Peer Node. Each value provided must be a valid IPv4 or IPv6 address.",
"items": {
"type": "string"
},
"maxItems": 128,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"isDynamic": {
"description": "If true, means the Peer Node was created dynamically as a result of dynamic peer discovery. isDynamic is read-only. Diameter Peer Nodes only.",
"readOnly": true,
"type": "boolean"
},
"maxAltRouteAttempts": {
"description": "The maximum number of times that a Request can be rerouted to this Peer Node before the next eligible Peer Node is selected.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"minConnCapacity": {
"description": "The minimum number of available Connections (/diameter/connections) to the Peer Node in order for it to be Available. Otherwise, if the number of available Connections to the Peer Node is less than minConnCapacity, the Peer Node is considered Degraded. Similarly, if no Connections are available to the Peer Node, it is considered Unavailable.",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"msgPriorityCfgSetName": {
"description": "The Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) assigned to a Peer Node supplies rules governing prioritization of request messages sent by the Peer Node to the DSR. Applicable when msgPrioritySetting is UserConfigured. Diameter Peer Nodes only.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPrioritySetting": {
"description": "When receiving a request message and the receiving Connection's (/diameter/connections) msgPrioritySetting (Message Priority Setting) is set to None, the Message Priority Setting determines how priority is assigned to the Request. When set to RequestMessage, the message priority assigned to a request received from the Peer Node is read from the message itself. This option should only be used when the Peer Node is an Oracle Communications DSR. When set to None, the Default Message Priority Configuration Set (/diameter/messagepriorityconfigurationsets) is used. When set to UserConfigured, the Message Priority Configuration Set assigned to this Peer Node is used to determine the priority of request messages received from the Peer Node. Diameter Peer Nodes only.",
"enum": [
"None",
"RequestMessage",
"UserConfigured"
],
"type": "string"
},
"name": {
"description": "Name for the Peer Node, which must be unique within the DSR site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeGroupName": {
"description": "Name of the Peer Node Group (/diameter/peernodegroups) to which this Peer Node is assigned.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimers) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Peer Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"replaceDestHost": {
"description": "If set to true, indicates the Destination-Host AVP of outgoing messages should be overwritten with this Peer Node's Fully Qualified Domain Name. Diameter Peer Nodes only.",
"type": "boolean"
},
"replaceDestRealm": {
"description": "If set to true, indicates that the Destination-Realm AVP of outgoing messages should be overwritten with this Peer Node's Realm. Diameter Peer Nodes only.",
"type": "boolean"
},
"routingOptionSetName": {
"description": "Name of the Routing Option Set (/diameter/routingoptionsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpPort": {
"description": "SCTP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for SCTP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"serverPort": {
"description": "UDP port(s) that serve(s) as the destination port(s) for messages from the DSR to this Peer Node, which represents a RADIUS Server. Between one and ten (inclusive) UDP server ports must be specified for a RADIUS Peer Node. RADIUS Peer Nodes only.",
"items": {
"maximum": 49151,
"minimum": 1024,
"type": "integer"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"tcpPort": {
"description": "TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TCP Connections from the DSR. Typical value is 3868. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"tlsPort": {
"description": "TLS/TCP Listen Port number of this Peer Node. Omitting this property indicates the Peer Node does not listen for TLS/TCP Connections from the DSR. Typical value is 5658. Diameter Peer Nodes only.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"topologyHidingEnabled": {
"description": "If true, indicates Topology Hiding is applicable to this Peer Node. Diameter Peer Nodes only.",
"type": "boolean"
},
"transactionCfgSetName": {
"description": "Name of the Transaction Configuration Set (/diameter/transactionconfigurationsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"aaaProtocol",
"fqdn",
"maxAltRouteAttempts",
"minConnCapacity",
"name",
"realm"
],
"type": "object"
}
Example
{
"aaaProtocol": "Diameter",
"altRtOnAnswerResultCode": "DifferentPeer",
"altRtOnAnswerTimeout": "DifferentPeer",
"altRtOnConnFailure": "DifferentPeer",
"answerOnAnyEnabledConnection": false,
"fqdn": "PeerNode3.realm1.com",
"ignorePriorityFromPeer": false,
"ip": [
"172.016.001.004",
"fe80:0000:0000:0000:0200:f8ff:fe21:67cf"
],
"isDynamic": false,
"maxAltRouteAttempts": 4,
"minConnCapacity": 1,
"msgPriorityCfgSet": "Default",
"msgPrioritySetting": "None",
"name": "PeerNode4",
"realm": "realm1.com",
"replaceDestHost": false,
"replaceDestRealm": false,
"sctpPort": 1059,
"tcpPort": 1699,
"topologyHidingEnabled": false
}
delete /diameter/peernodes/{name}
Deletes the specified Peer Node from the SOAM configuration. A Peer Node will only be deleted if all delete validation checks pass. In general, if the Peer Node is part of the configuration of some other Managed Object, the Peer Node cannot be deleted. For example, if the Peer Node is named in a Peer Route Group (/diameter/routegroups), the Peer Node must first be removed from the Route Group. Then the Peer Node can be deleted from the configuration. An attempt to delete a Peer Node that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/diameter/peernodes/{name}/status
get /diameter/peernodes/{name}/status
Retrieves the operational status for the specified Peer Node.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/peernodestatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peernode/peernodestatus.json",
"properties": {
"connection": {
"description": "The list of details of Connections (/diameter/connections) associated with a peer node. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties":{
"connectionAlarmGroupName": {
"description": "A name given to a group of Connections (/diameter/connectionalarmgroups). Connection Alarm Group is used by Alarm Group feature if it is enabled. The feature can be enabled through Options (/diameter/options). This parameter will be present in the status data only if Alarm Group feature is enabled and Connection Alarm Group is created.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"connectionAlarmIds": {
"description": "Alarm Id raised for the connection by the DAMP. This parameter will be present in the status data only if Alarm Group feature is enabled through Options (/diameter/options).",
"readOnly": true,
"type": "array"
},
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"connectionOperationalReason": {
"description": "Reason for the connection Operational Status. Information is also available for each connection.",
"maxLength": 32,
"readOnly": true,
"type": "string"
},
"connectionOperationalStatus": {
"description": "Tells connection operational status. When Available is specified, at least one Peer Node connection is available for routing. When Degraded is specified, the Peer Node connection is not unavailable but it is not operating as expected. When Unavailable is specified all connections for a Peer Node are unavailable. The Operational Reason field provides additional information Degraded and Unavailable status.",
"enum": [
"Available",
"Degraded",
"Unavailable"
],
"readOnly": true,
"type": "string"
},
"connectionTimeOfLastUpdate": {
"description": "The date/time the status for this specific connection of Peer Node Table was last updated by the DSR.",
"readOnly": true,
"type": "string"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For the Peer Node status:In case of Multiple Active DA-MP configuration, the MP Leader always reports the Peer Node status and in case of Active/Standby DA-MP configuration, the Active DA-MP reports the Peer Node status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Peer Node was created dynamically as a result of dynamic peer discovery.",
"readOnly": true,
"type": "boolean"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For the Peer Node status:In case of Multiple Active DA-MP configuration, the MP Leader always reports the Peer Node status and in case of Active/Standby DA-MP configuration, the Active DA-MP reports the Peer Node status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
},
"peerNodeAlarmGroupName": {
"description": "A name given to a group of Peer Nodes (/diameter/peernodealarmgroups). Peer Node Alarm Group is used by Alarm Group feature if it is enabled. The feature can be enabled through Options (/diameter/options). This parameter will be present in the status data only if Alarm Group feature is enabled and Peer Node Alarm Group is created.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNodeAlarmIds": {
"description": "Alarm Id raised for the peer by the DAMP. This parameter will be present in the status data only if Alarm Group feature is enabled through Options (/diameter/options).",
"readOnly": true,
"type": "array"
},
"peerNodeGrpName": {
"description": "Name of the Peer Node Group (/diameter/peernodegroups) to which this Peer Node is assigned.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNodeName": {
"description": "This peernode name is the name configured through /diameter/peernodes, which must be unique within the DSR site. A name is required, and cannot be changed after the Peer Node is initially configured.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerOperationalReason": {
"description": "Reason for the Peer Node Operational Status. Information is also available for each connection.",
"maxLength": 32,
"readOnly": true,
"type": "string"
},
"peerOperationalStatus": {
"description": "Tells peer node operational status. When Available is specified, at least one Peer Node connection is available for routing. When Degraded is specified, the Peer Node connection is not unavailable but it is not operating as expected. When Unavailable is specified all connections for a Peer Node are unavailable. The Operational Reason field provides additional information Degraded and Unavailable status.",
"enum": [
"Available",
"Degraded",
"Unavailable"
],
"readOnly": true,
"type": "string"
},
"peerTimeOfLastUpdate": {
"description": "The date/time the status for this specific peer of Peer Node Table was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"readOnly": true,
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection/Peer Status are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection/Peer. If the OAM has current status for this Connection Status, statusKnown is set to true.",
"type": "boolean"
},
"transactionCfgSetName": {
"description": "Name of the Transaction Configuration Set (/diameter/transactionconfigurationsets) associated with this Peer Node.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"connection": [
{
"connectionAlarmIds": [
"22308",
"22307"
],
"mpServerHostName": "MP1",
"connectionAlarmGroupName": "connectionalarmgroup1",
"connectionName": "hss",
"connectionOperationalReason": "Disabled",
"connectionOperationalStatus": "Available",
"connectionTimeOfLastUpdate": "2018-Mar-05 11:05:05 EDT"
}
],
"isDynamic": false,
"mpServerHostName": "MP1",
"peerNodeAlarmIds": [
"22308",
"22307"
],
"peerNodeAlarmGroupName": "peernodealarmgroup1",
"peerNodeName": "hss",
"peerOperationalReason": "Normal",
"peerOperationalStatus": "Available",
"peerTimeOfLastUpdate": "2018-Feb-21 11:05:05 EDT",
"statusKnown": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Peer Route Rules
Peer Route Rules are the individual rules that specify how ingress request messages are routed by the DSR. Each Peer Route Rule is associated with exactly one Peer Route Table (/diameter/peerroutetables). Whenever a request message is processed by the DSR, one of the configured Peer Route Tables is selected (based on the DSR's general routing behavior, tailored by the DSR's specific configuration), and then the Peer Route Rules owned by the selected Peer Route Table are evaluated to see which Rule is applied to the request message. All Peer Route Rules associated with a Peer Route Table form the prioritized set of rules against which the request message is compared. The request is then routed based on the configuration of the selected Rule.
Each Peer Route Rule specifies criteria, called conditions, against which the request message is compared. Each Rule also has a defined priority. The action taken by the DSR in response to the request message is based on the highest-priority Peer Route Rule whose conditions match the request message information. The possible actions are: route to a destination Peer Node (/diameter/peernodes) (which occurs when the Route List specified in the Rule is evaluated and a Peer Node is selected); send an answer message to the ingress Peer Node that transmitted the request message; or abandon the request message.
All Peer Route Rule configuration is done at the SOAM.
/diameter/peerrouterules
get /diameter/peerrouterules
Returns all Peer Route Rules configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Peer Route Rules meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peerrouteruleCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerrouterule/peerrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToPeer, DSR routes the message to a Peer Node (/diameter/peernodes) using the Route List (/diameter/routelists) associated with this Rule. When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the Answer Result-Code Value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node. When set to RouteToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"RouteToPeer",
"RouteToPrt",
"SendAnswer"
],
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Peer Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diamAnsCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"errorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"msgCpyCfgSetName": {
"description": "The name of the Message Copy Configuration Set (/diameter/messagecopyconfigurationsets) used for copying the messages to the Diameter Application Server (DAS) when the action property is RouteToPeer. A valid msgCpyCfgSetName causes messages matched by this Peer Route Rule to be marked for copy to the DAS. If no message copy is required as a result of this Rule being hit, msgCpyCfgSetName can be omitted.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriority": {
"description": "The priority given to a Request message forwarded as the result of this Rule when the action property is set to RouteToPeer. When msgPriority is set to Nc (no change), the priority value within the forwarded request message is left unchanged. When set to a value other than Nc, the priority value within the ingress request message is explicitly set to the specified value, where Pr0 (priority 0) is the lowest priority.",
"enum": [
"Nc",
"Pr0",
"Pr1",
"Pr2",
"Pr3",
"Pr4",
"Pr5",
"Pr6",
"Pr7",
"Pr8",
"Pr9",
"Pr10",
"Pr11",
"Pr12",
"Pr13",
"Pr14",
"Pr15"
],
"type": "string"
},
"name": {
"description": "Name for the Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "The name of the Peer Route Table (/diameter/peerroutetables) to which this Peer Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Peer Route Table (/diameter/peerroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this Rule. A valid Route List name is required whenever the action is RouteToPeer.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"targetPrtName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Peer Route Rule's action is RouteToPrt.",
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"conditions",
"name",
"peerRouteTableName",
"priority"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action":"SendAnswer",
"conditions":
{
"appId":
{
"operator":"DontCare"
} ,
"cmdCode":
{
"operator":"Equal",
"value":"1"
},
"destHost":
{
"operator":"EndsWith",
"value":"domain.com"
},
"destRealm":
{
"operator":"EndsWith",
"value":"domain.com"
},
"origHost":
{
"operator":"DontCare"
},
"origRealm":
{
"operator":"NotEqual",
"value":"dp.domain.com"
}
},
"diamAnsCode": 1000,
"errorMessage": "ErrorMessage",
"msgPriority": "Nc",
"name": "PeerRouteRule31",
"peerRouteTableName": "Default",
"priority": 1
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/peerrouterules
Adds a new Peer Route Rule to the specified Peer Route Table (/diameter/peerroutetables). Even though a Peer Route Rule is owned by a single Peer Route Table, each Peer Route Rule must have a name that is unique across all Peer Route Tables configured at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerrouterule/peerrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToPeer, DSR routes the message to a Peer Node (/diameter/peernodes) using the Route List (/diameter/routelists) associated with this Rule. When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the Answer Result-Code Value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node. When set to RouteToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"RouteToPeer",
"RouteToPrt",
"SendAnswer"
],
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Peer Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diamAnsCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"errorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"msgCpyCfgSetName": {
"description": "The name of the Message Copy Configuration Set (/diameter/messagecopyconfigurationsets) used for copying the messages to the Diameter Application Server (DAS) when the action property is RouteToPeer. A valid msgCpyCfgSetName causes messages matched by this Peer Route Rule to be marked for copy to the DAS. If no message copy is required as a result of this Rule being hit, msgCpyCfgSetName can be omitted.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriority": {
"description": "The priority given to a Request message forwarded as the result of this Rule when the action property is set to RouteToPeer. When msgPriority is set to Nc (no change), the priority value within the forwarded request message is left unchanged. When set to a value other than Nc, the priority value within the ingress request message is explicitly set to the specified value, where Pr0 (priority 0) is the lowest priority.",
"enum": [
"Nc",
"Pr0",
"Pr1",
"Pr2",
"Pr3",
"Pr4",
"Pr5",
"Pr6",
"Pr7",
"Pr8",
"Pr9",
"Pr10",
"Pr11",
"Pr12",
"Pr13",
"Pr14",
"Pr15"
],
"type": "string"
},
"name": {
"description": "Name for the Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "The name of the Peer Route Table (/diameter/peerroutetables) to which this Peer Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Peer Route Table (/diameter/peerroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this Rule. A valid Route List name is required whenever the action is RouteToPeer.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"targetPrtName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Peer Route Rule's action is RouteToPrt.",
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"conditions",
"name",
"peerRouteTableName",
"priority"
],
"type": "object"
}
Example
{
"action":"SendAnswer",
"conditions":
{
"appId":
{
"operator":"DontCare"
} ,
"cmdCode":
{
"operator":"Equal",
"value":"1"
},
"destHost":
{
"operator":"EndsWith",
"value":"domain.com"
},
"destRealm":
{
"operator":"EndsWith",
"value":"domain.com"
},
"origHost":
{
"operator":"DontCare"
},
"origRealm":
{
"operator":"NotEqual",
"value":"dp.domain.com"
}
},
"diamAnsCode": 1000,
"errorMessage": "ErrorMessage",
"msgPriority": "Nc",
"name": "PeerRouteRule31",
"peerRouteTableName": "Default",
"priority": 1
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/peerrouterules/{name}
get /diameter/peerrouterules/{name}
Returns the configuration details for the specified Peer Route Rule. If the specified Peer Route Rule does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/peerrouteruleItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerrouterule/peerrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToPeer, DSR routes the message to a Peer Node (/diameter/peernodes) using the Route List (/diameter/routelists) associated with this Rule. When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the Answer Result-Code Value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node. When set to RouteToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"RouteToPeer",
"RouteToPrt",
"SendAnswer"
],
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Peer Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diamAnsCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"errorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"msgCpyCfgSetName": {
"description": "The name of the Message Copy Configuration Set (/diameter/messagecopyconfigurationsets) used for copying the messages to the Diameter Application Server (DAS) when the action property is RouteToPeer. A valid msgCpyCfgSetName causes messages matched by this Peer Route Rule to be marked for copy to the DAS. If no message copy is required as a result of this Rule being hit, msgCpyCfgSetName can be omitted.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriority": {
"description": "The priority given to a Request message forwarded as the result of this Rule when the action property is set to RouteToPeer. When msgPriority is set to Nc (no change), the priority value within the forwarded request message is left unchanged. When set to a value other than Nc, the priority value within the ingress request message is explicitly set to the specified value, where Pr0 (priority 0) is the lowest priority.",
"enum": [
"Nc",
"Pr0",
"Pr1",
"Pr2",
"Pr3",
"Pr4",
"Pr5",
"Pr6",
"Pr7",
"Pr8",
"Pr9",
"Pr10",
"Pr11",
"Pr12",
"Pr13",
"Pr14",
"Pr15"
],
"type": "string"
},
"name": {
"description": "Name for the Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "The name of the Peer Route Table (/diameter/peerroutetables) to which this Peer Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Peer Route Table (/diameter/peerroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this Rule. A valid Route List name is required whenever the action is RouteToPeer.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"targetPrtName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Peer Route Rule's action is RouteToPrt.",
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"conditions",
"name",
"peerRouteTableName",
"priority"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action":"SendAnswer",
"conditions":
{
"appId":
{
"operator":"DontCare"
} ,
"cmdCode":
{
"operator":"Equal",
"value":"1"
},
"destHost":
{
"operator":"EndsWith",
"value":"domain.com"
},
"destRealm":
{
"operator":"EndsWith",
"value":"domain.com"
},
"origHost":
{
"operator":"DontCare"
},
"origRealm":
{
"operator":"NotEqual",
"value":"dp.domain.com"
}
},
"diamAnsCode": 1000,
"errorMessage": "ErrorMessage",
"msgPriority": "Nc",
"name": "PeerRouteRule31",
"peerRouteTableName": "Default",
"priority": 1
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/peerrouterules/{name}
Updates the configuration for the specified Peer Route Rule. If the provided Peer Route Rule data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerrouterule/peerrouterule.json",
"properties": {
"action": {
"description": "Action associated with this Rule. When set to RouteToPeer, DSR routes the message to a Peer Node (/diameter/peernodes) using the Route List (/diameter/routelists) associated with this Rule. When set to SendAnswer, DSR abandons message routing and sends an Answer response containing the Answer Result-Code Value associated with this Rule. When set to AbandonWithNoAns, DSR discards the message and an Answer is not sent to the originating Peer Node. When set to RouteToPrt, DSR routes the message to the Peer Route Table (/diameter/peerroutetables) for further processing.",
"enum": [
"AbandonWithNoAns",
"RouteToPeer",
"RouteToPrt",
"SendAnswer"
],
"type": "string"
},
"conditions": {
"description": "The conditions associated with this Peer Route Rule. There are six conditions, and because DSR logically ANDs them, all six must be present in the Rule definition. However, any individual condition, which does not apply to the Rule, should simply have the DontCare operator assigned. The six conditions are Destination-Realm, Destination-Host, Application-Id, Command-Code, Origin-Realm, and Origin-Host. Application-Id and Command-Code refer to values found in the Diameter request message header, while the other four conditions apply to AVPs within the Diameter message body.",
"properties": {
"appId": {
"description": "The appId condition is used when it is necessary to examine the Application-Id value in the Diameter request message. The Equal operator is used to match the message's Application-ID value exactly. The NotEqual operator is used to exclude a specific Application-Id value. In either the Equal or NotEqual case, the supplied value must be an integer in the range 0-4294967295. If Application-Id is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
}
},
"required": [
"operator"
],
"type": "object"
},
"cmdCode": {
"description": "The cmdCode condition is used when it is necessary to examine the Command-Code value in the Diameter request message. The Equal operator is used to match the message's Command-Code value exactly. The NotEqual operator is used to exclude a specific Command-Code value. In either the Equal or NotEqual case, the supplied value must be a configured Command Code or Extended Command Code. Command Codes are integers in the range 0-16777215, while Extended Command Codes have the form X.Y.Z, where each of X (the Command Code), Y (the AVP code), and Z (the AVP value) are integers in the range 0-16777215. If Command-Code is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"DontCare",
"Equal",
"NotEqual"
],
"type": "string"
},
"value": {
"maxLength": 30,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destHost": {
"description": "The destHost condition is used when it is necessary to examine the Destination-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Host AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. If Destination-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. In addition, the Present and Absent operators can be used with Destination-Host. Neither Present nor Absent takes a value. If Present is used, there is a match when the Destination-Host AVP is present in the request message. If Absent is used, there is a match when the Destination-Host AVP is not present in the request message.",
"properties": {
"operator": {
"enum": [
"Absent",
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"Present",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"destRealm": {
"description": "The destRealm condition is used when it is necessary to examine the Destination-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Destination-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Destination-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Destination-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Destination-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origHost": {
"description": "The origHost condition is used when it is necessary to examine the Origin-Host AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Host AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Host value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Host AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Host is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
},
"origRealm": {
"description": "The origRealm condition is used when it is necessary to examine the Origin-Realm AVP value in the Diameter request message. The Equal operator is used to match the message's Origin-Realm AVP value exactly. The NotEqual operator is used to exclude a specific Origin-Realm value. In these two cases, the supplied value must be a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label can be no longer than 63 characters and the string can be no longer than 255 characters. The StartsWith, EndsWith, and Contains operators are used as their names infer, to match the beginning, end, or any contiguous part of the Origin-Realm AVP value. In any of these cases, the supplied value is a case-insensitive string limited to alphanumeric, dash ('-'), dot ('.'), and underscore ('_') characters. For EndsWith or StartsWith, the string can be no longer than 255 characters. For Contains, the string can be no longer than 50 characters. If Origin-Realm is not a necessary condition for this Rule, the DontCare operator must be specified, and the value attribute is ignored.",
"properties": {
"operator": {
"enum": [
"Contains",
"DontCare",
"EndsWith",
"Equal",
"NotEqual",
"StartsWith"
],
"type": "string"
},
"value": {
"maxLength": 255,
"type": "string"
}
},
"required": [
"operator"
],
"type": "object"
}
},
"required": [
"appId",
"destRealm",
"origRealm",
"origHost",
"destHost",
"cmdCode"
],
"type": "object"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"diamAnsCode": {
"description": "The value placed in the Result-Code AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"errorMessage": {
"description": "The string placed in the Error-Message AVP of the Answer message whenever the action is set to SendAnswer.",
"maxLength": 64,
"type": "string"
},
"msgCpyCfgSetName": {
"description": "The name of the Message Copy Configuration Set (/diameter/messagecopyconfigurationsets) used for copying the messages to the Diameter Application Server (DAS) when the action property is RouteToPeer. A valid msgCpyCfgSetName causes messages matched by this Peer Route Rule to be marked for copy to the DAS. If no message copy is required as a result of this Rule being hit, msgCpyCfgSetName can be omitted.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"msgPriority": {
"description": "The priority given to a Request message forwarded as the result of this Rule when the action property is set to RouteToPeer. When msgPriority is set to Nc (no change), the priority value within the forwarded request message is left unchanged. When set to a value other than Nc, the priority value within the ingress request message is explicitly set to the specified value, where Pr0 (priority 0) is the lowest priority.",
"enum": [
"Nc",
"Pr0",
"Pr1",
"Pr2",
"Pr3",
"Pr4",
"Pr5",
"Pr6",
"Pr7",
"Pr8",
"Pr9",
"Pr10",
"Pr11",
"Pr12",
"Pr13",
"Pr14",
"Pr15"
],
"type": "string"
},
"name": {
"description": "Name for the Rule, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerRouteTableName": {
"description": "The name of the Peer Route Table (/diameter/peerroutetables) to which this Peer Route Rule belongs.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"priority": {
"description": "Priority of this Rule within the Peer Route Table (/diameter/peerroutetables). A lower value means a higher priority, so a Rule whose priority is a smaller integer is preferred over a Rule whose priority is a larger integer when the two Rules are being compared for selection.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"routeListName": {
"description": "The name of the Route List (/diameter/routelists) associated with this Rule. A valid Route List name is required whenever the action is RouteToPeer.",
"maxLength": 32,
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"targetPrtName": {
"description": "Name of the Peer Route Table (/diameter/peerroutetables) where the message is forwarded for further processing. Clients supply a value for this attribute only when this Peer Route Rule's action is RouteToPrt.",
"type": "string"
},
"vendorId": {
"description": "The value placed in the Vendor-Id AVP of the Answer message sent whenever the action is set to SendAnswer.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"action",
"conditions",
"name",
"peerRouteTableName",
"priority"
],
"type": "object"
}
Example
{
"action":"SendAnswer",
"conditions":
{
"appId":
{
"operator":"DontCare"
} ,
"cmdCode":
{
"operator":"Equal",
"value":"1"
},
"destHost":
{
"operator":"EndsWith",
"value":"domain.com"
},
"destRealm":
{
"operator":"EndsWith",
"value":"domain.com"
},
"origHost":
{
"operator":"DontCare"
},
"origRealm":
{
"operator":"NotEqual",
"value":"dp.domain.com"
}
},
"diamAnsCode": 1000,
"errorMessage": "ErrorMessage",
"msgPriority": "Nc",
"name": "PeerRouteRule31",
"peerRouteTableName": "Default",
"priority": 1
}
delete /diameter/peerrouterules/{name}
Deletes the specified Peer Route Rule from the SOAM configuration. A Peer Route Rule can always be deleted - there are no validation checks when deleting a Rule.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Peer Route Tables
A Peer Route Table (PRT) is a collection of prioritized Peer Route Rules (/diameter/peerrouterules) the DSR searches to determine how to route a Diameter request message to a specific destination Peer Node (/diameter/peernodes). An SOAM can be configured with multiple Peer Route Tables, each of which covers a partial yet distinct subset of routing scenarios. The number and content of Peer Route Tables configured at an SOAM depends entirely on the DSR's required role within the larger Diameter network.
A given PRT can be associated with a particular Peer Node, with a particular Diameter Application ID (/diameter/applicationids), or with a Diameter Application ID/Command Code (/diameter/commandcodes) combination.
Request messages received by the DSR are compared against the Peer Route Rules within the applicable PRT. The action taken by the DSR in response to the request message is based on the highest-priority Peer Route Rule that matches the request message information. The possible actions are: route to a destination Peer Node, send an answer message to the ingress Peer Node that originated the Diameter request message, or abandon the request message.
All Peer Route Table configuration is done at the SOAM.
/diameter/peerroutetables
get /diameter/peerroutetables
Returns all Peer Route Tables configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Peer Route Tables meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/peerroutetableCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerroutetable/peerroutetable.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Peer Route Table, which must be unique within the DSR site. A name is required, and cannot be changed after the PRT is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "387",
"name": "peerRouteTable1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/peerroutetables
Adds a new Peer Route Table to the DSR configuration. The new Peer Route Table must have a name unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerroutetable/peerroutetable.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Peer Route Table, which must be unique within the DSR site. A name is required, and cannot be changed after the PRT is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "387",
"name": "peerRouteTable1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/peerroutetables/{name}
get /diameter/peerroutetables/{name}
Returns the configuration details for the specified Peer Route Table. If the specified Peer Route Table does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/peerroutetableItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/peerroutetable/peerroutetable.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Peer Route Table, which must be unique within the DSR site. A name is required, and cannot be changed after the PRT is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "387",
"name": "peerRouteTable1"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /diameter/peerroutetables/{name}
Deletes the specified Peer Route Table from the SOAM configuration. A Peer Route Table is only deleted if all delete validation checks pass. If the Peer Route Table is part of the configuration of some other Managed Object, the Peer Route Table cannot be deleted. For example, if the Peer Route Table is associated with a Peer Node (/diameter/peernodes), that association must first be removed (either by editing the Peer Node and choosing a different PRT, or deleting the Peer Node entirely). Then the Peer Route Table can be deleted from the configuration. An attempt to delete a Peer Route Table that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Pending Answer Timers
A Pending Answer Timer (PAT) is simply a named time duration, in milliseconds, which defines how long the DSR waits before it considers a Diameter or RADIUS request message to have timed out. A PAT can be associated directly with a Peer Node (/diameter/peernodes); it can be configured in a Routing Option Set (/diameter/routingoptionsets); or it can be configured as part of a Transaction Configuration Set (/diameter/transactionconfigurationsets) rule. The action the DSR takes when a request message times out depends on other routing configuration; the Pending Answer Timer simply identifies how long the DSR waits before a request message associated with a particular Peer Node, Routing Option Set, or Transaction Configuration Set rule is considered to have timed out.
Note that a new Pending Answer Timer is used each time a request is sent to a Peer Node. If the request is sent multiple times, a new PAT is used each time the message is sent. This distinguishes PATs from the transactionLifetime attribute of a Routing Option Set, which spans the total time allowed for all attempts to send a particular message.
/diameter/pendinganswertimers
get /diameter/pendinganswertimers
Returns all configured Pending Answer Timers.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/pendinganswertimerCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendinganswertimer/pendinganswertimer.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Pending Answer Timer, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"value": {
"description": "This value indicates how long, in milliseconds, the DSR waits to receive an answer message from the upstream Peer Node (/diameter/peernodes) after forwarding a request message. Typical value is 1000.",
"maximum": 180000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"name",
"value"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "321",
"name": "Default_123",
"value": 1000
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/pendinganswertimers
Adds a new Pending Answer Timer to the DSR configuration. The new PAT must have a name that is unique across all PATs at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendinganswertimer/pendinganswertimer.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Pending Answer Timer, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"value": {
"description": "This value indicates how long, in milliseconds, the DSR waits to receive an answer message from the upstream Peer Node (/diameter/peernodes) after forwarding a request message. Typical value is 1000.",
"maximum": 180000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"name",
"value"
],
"type": "object"
}
Example
{
"configurationLevel": "321",
"name": "Default_123",
"value": 1000
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/pendinganswertimers/{name}
get /diameter/pendinganswertimers/{name}
Returns the configuration details for the specified Pending Answer Timer. If the specified PAT does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/pendinganswertimerItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendinganswertimer/pendinganswertimer.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Pending Answer Timer, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"value": {
"description": "This value indicates how long, in milliseconds, the DSR waits to receive an answer message from the upstream Peer Node (/diameter/peernodes) after forwarding a request message. Typical value is 1000.",
"maximum": 180000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "321",
"name": "Default_123",
"value": 1000
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/pendinganswertimers/{name}
Updates the configuration for the specified Pending Answer Timer. If the provided PAT data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendinganswertimer/pendinganswertimer.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Pending Answer Timer, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"value": {
"description": "This value indicates how long, in milliseconds, the DSR waits to receive an answer message from the upstream Peer Node (/diameter/peernodes) after forwarding a request message. Typical value is 1000.",
"maximum": 180000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"name",
"value"
],
"type": "object"
}
Example
{
"configurationLevel": "321",
"name": "Default_123",
"value": 1000
}
delete /diameter/pendinganswertimers/{name}
Deletes the specified Pending Answer Timer from the SOAM configuration. A PAT will only be deleted if all delete validation checks pass. In general, if the PAT is part of the configuration of some other Managed Object, the PAT cannot be deleted. For example, if the PAT is named by a Transaction Configuration Set (/diameter/transactionconfigurationset) rule, the PAT must first be removed from the rule. Then the PAT can be deleted from the configuration. An attempt to delete a PAT that cannot be deleted will result in an error message returned within the HTTP response.
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Pending Transaction Limiting Configuration Sets
Pending Transaction Limiting Configuration Sets provide the mechanism to enter configuration data needed by Egress Throttle Groups (ETGs) (/diameter/egressthrottlegroups) (on the SOAM) and Egress Throttle Lists (ETLs) (/diameter/egressthrottlelists) (on the NOAM) to determine when to start throttling for pending transactions.
Pending Transaction Limiting Configuration Sets can be configured at either the NOAM or the SOAM. When configured at the NOAM, the Pending Transaction Limiting Configuration Set can be applied to any ETL also configured at the NOAM. When configured at the SOAM, the Pending Transaction Limiting Configuration Set can be applied to any ETG also configured at the same SOAM. Under no circumstance can a Pending Transaction Limiting Configuration Set configured at the NOAM be assigned to an ETG, nor can a Configuration Set configured at an SOAM be assigned to an ETL.
/diameter/pendingtransactionlimitingconfigurationsets
get /diameter/pendingtransactionlimitingconfigurationsets
Returns all Pending Transaction Limiting Configuration Sets configured at the NOAM or SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Pending Transaction Limiting Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Servers: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/pendingtransactionlimitingconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendingtransactionlimitingconfigurationset/pendingtransactionlimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxPendTrans": {
"description": "The maximum allowed egress pending transactions shared by associated members.",
"maximum": 1000000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Pending Transaction Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Pending Transaction Limiting Configuration Sets.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"pendTransAbateThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"pendTransAbateThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"pendTransAbateThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"pendTransAbateTime": {
"description": "The time, in milliseconds, the egress pending transactions must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"pendTransOnsetThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"pendTransOnsetThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"pendTransOnsetThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxPendTrans",
"name",
"pendTransAbateThresh1",
"pendTransAbateTime",
"pendTransOnsetThresh1"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "47",
"maxPendTrans": 6000,
"name": "PendingTransactionLimitingConfiguration1",
"pendTransAbateThresh1": 55,
"pendTransAbateThresh2": 65,
"pendTransAbateThresh3": 80,
"pendTransAbateTime": 50,
"pendTransOnsetThresh1": 60,
"pendTransOnsetThresh2": 70,
"pendTransOnsetThresh3": 90
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/pendingtransactionlimitingconfigurationsets
Adds a new Pending Transaction Limiting Configuration Set to the configuration of the NOAM or SOAM that receives the POST request. The new Pending Transaction Limiting Configuration Set name must be unique to the OAM server that receives the POST request.
Target Servers: NOAM or SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendingtransactionlimitingconfigurationset/pendingtransactionlimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxPendTrans": {
"description": "The maximum allowed egress pending transactions shared by associated members.",
"maximum": 1000000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Pending Transaction Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Pending Transaction Limiting Configuration Sets.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"pendTransAbateThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"pendTransAbateThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"pendTransAbateThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"pendTransAbateTime": {
"description": "The time, in milliseconds, the egress pending transactions must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"pendTransOnsetThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"pendTransOnsetThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"pendTransOnsetThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxPendTrans",
"name",
"pendTransAbateThresh1",
"pendTransAbateTime",
"pendTransOnsetThresh1"
],
"type": "object"
}
Example
{
"configurationLevel": "47",
"maxPendTrans": 6000,
"name": "PendingTransactionLimitingConfiguration1",
"pendTransAbateThresh1": 55,
"pendTransAbateThresh2": 65,
"pendTransAbateThresh3": 80,
"pendTransAbateTime": 50,
"pendTransOnsetThresh1": 60,
"pendTransOnsetThresh2": 70,
"pendTransOnsetThresh3": 90
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/pendingtransactionlimitingconfigurationsets/{name}
get /diameter/pendingtransactionlimitingconfigurationsets/{name}
Returns the configuration details for the Pending Transaction Limiting Configuration Set. If the Pending Transaction Limiting Configuration Set does not exist in the target SOAM's or NOAM's configuration, an error message is returned within the HTTP response.
Target Servers: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/pendingtransactionlimitingconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendingtransactionlimitingconfigurationset/pendingtransactionlimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxPendTrans": {
"description": "The maximum allowed egress pending transactions shared by associated members.",
"maximum": 1000000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Pending Transaction Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Pending Transaction Limiting Configuration Sets.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"pendTransAbateThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"pendTransAbateThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"pendTransAbateThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"pendTransAbateTime": {
"description": "The time, in milliseconds, the egress pending transactions must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"pendTransOnsetThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"pendTransOnsetThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"pendTransOnsetThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxPendTrans",
"name",
"pendTransAbateThresh1",
"pendTransAbateTime",
"pendTransOnsetThresh1"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "47",
"maxPendTrans": 6000,
"name": "PendingTransactionLimitingConfiguration1",
"pendTransAbateThresh1": 55,
"pendTransAbateThresh2": 65,
"pendTransAbateThresh3": 80,
"pendTransAbateTime": 50,
"pendTransOnsetThresh1": 60,
"pendTransOnsetThresh2": 70,
"pendTransOnsetThresh3": 90
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/pendingtransactionlimitingconfigurationsets/{name}
Updates the configuration of the specified Pending Transaction Limiting Configuration Set.
Target Servers: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/pendingtransactionlimitingconfigurationset/pendingtransactionlimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxPendTrans": {
"description": "The maximum allowed egress pending transactions shared by associated members.",
"maximum": 1000000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Pending Transaction Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Pending Transaction Limiting Configuration Sets.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"pendTransAbateThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"pendTransAbateThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"pendTransAbateThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions falls below the pendTransAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"pendTransAbateTime": {
"description": "The time, in milliseconds, the egress pending transactions must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"pendTransOnsetThresh1": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"pendTransOnsetThresh2": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"pendTransOnsetThresh3": {
"description": "A percentage of maxPendTrans. When the number of egress pending transactions exceeds the pendTransOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxPendTrans",
"name",
"pendTransAbateThresh1",
"pendTransAbateTime",
"pendTransOnsetThresh1"
],
"type": "object"
}
Example
{
"configurationLevel": "47",
"maxPendTrans": 6000,
"name": "PendingTransactionLimitingConfiguration1",
"pendTransAbateThresh1": 55,
"pendTransAbateThresh2": 65,
"pendTransAbateThresh3": 80,
"pendTransAbateTime": 50,
"pendTransOnsetThresh1": 60,
"pendTransOnsetThresh2": 70,
"pendTransOnsetThresh3": 90
}
delete /diameter/pendingtransactionlimitingconfigurationsets/{name}
Deletes the specified Pending Transaction Limiting Configuration Set from the SOAM or NOAM configuration. A Pending Transaction Limiting Configuration Set can only be deleted if all delete validation checks pass. In general, if the Pending Transaction Limiting Configuration Set is part of the configuration of some other Managed Object, the Pending Transaction Limiting Configuration Set cannot be deleted. For example, if the Pending Transaction Limiting Configuration Set is named in an Egress Throttle Group (/diameter/egressthrottlegroups), the Pending Transaction Limiting Configuration Set must be removed from the Egress Throttle Group. Then the Pending Transaction Limiting Configuration Set can be deleted from the configuration. An attempt to delete a Pending Transaction Limiting Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Servers: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Topology Hiding Protected Networks
A Protected Network component contains Topology Hiding (TH) configuration data that is used when messages to and from that network are to be protected using Topology Hiding.
All Protected Network configuration is done at the NOAM.
/diameter/protectednetworks
get /diameter/protectednetworks
Returns all Protected Networks configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Protected Networks meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/protectednetworkCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/protectednetwork/protectednetwork.json",
"properties": {
"afTopologyHidingCfgSet": {
"description": "S9 AF/pCSCF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"hssTopologyHidingCfgSet": {
"description": "S6a/S6d HSS Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mmeTopologyHidingCfgSet": {
"description": "MME/SGSN Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pathTopologyHidingCfgSet": {
"description": "Path Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcrfTopologyHidingCfgSet": {
"description": "S9 PCRF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"protectedRealm": {
"description": "Name for Protected Network Realm, which must be unique within the DSR site. Protected Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"trustedNetList": {
"description": "Trusted Network List name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"protectedRealm"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"afTopologyHidingCfgSet": "MmiTestAfTopologyHidingCfgSet",
"hssTopologyHidingCfgSet": "Disabled",
"mmeTopologyHidingCfgSet": "MmiTestMmeTopologyHidingCfgSet",
"pathTopologyHidingCfgSet": "MmiTestPathTopologyHidingCfgSet",
"pcrfTopologyHidingCfgSet": "Disabled",
"protectedRealm": "MmiTestProtectedNetwork",
"trustedNetList": "Disabled"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/protectednetworks
Adds a new Protected Network to the DSR configuration. The new Protected Network must have a name that is unique to the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/protectednetwork/protectednetwork.json",
"properties": {
"afTopologyHidingCfgSet": {
"description": "S9 AF/pCSCF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"hssTopologyHidingCfgSet": {
"description": "S6a/S6d HSS Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mmeTopologyHidingCfgSet": {
"description": "MME/SGSN Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pathTopologyHidingCfgSet": {
"description": "Path Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcrfTopologyHidingCfgSet": {
"description": "S9 PCRF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"protectedRealm": {
"description": "Name for Protected Network Realm, which must be unique within the DSR site. Protected Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"trustedNetList": {
"description": "Trusted Network List name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"protectedRealm"
],
"type": "object"
}
Example
{
"afTopologyHidingCfgSet": "MmiTestAfTopologyHidingCfgSet",
"hssTopologyHidingCfgSet": "Disabled",
"mmeTopologyHidingCfgSet": "MmiTestMmeTopologyHidingCfgSet",
"pathTopologyHidingCfgSet": "MmiTestPathTopologyHidingCfgSet",
"pcrfTopologyHidingCfgSet": "Disabled",
"protectedRealm": "MmiTestProtectedNetwork",
"trustedNetList": "Disabled"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/protectednetworks/{name}
get /diameter/protectednetworks/{name}
Returns the configuration details for the specified Protected Network. If the specified Protected Network does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/protectednetworkItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/protectednetwork/protectednetwork.json",
"properties": {
"afTopologyHidingCfgSet": {
"description": "S9 AF/pCSCF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"hssTopologyHidingCfgSet": {
"description": "S6a/S6d HSS Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mmeTopologyHidingCfgSet": {
"description": "MME/SGSN Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pathTopologyHidingCfgSet": {
"description": "Path Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcrfTopologyHidingCfgSet": {
"description": "S9 PCRF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"protectedRealm": {
"description": "Name for Protected Network Realm, which must be unique within the DSR site. Protected Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"trustedNetList": {
"description": "Trusted Network List name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"protectedRealm"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"afTopologyHidingCfgSet": "MmiTestAfTopologyHidingCfgSet",
"hssTopologyHidingCfgSet": "Disabled",
"mmeTopologyHidingCfgSet": "MmiTestMmeTopologyHidingCfgSet",
"pathTopologyHidingCfgSet": "MmiTestPathTopologyHidingCfgSet",
"pcrfTopologyHidingCfgSet": "Disabled",
"protectedRealm": "MmiTestProtectedNetwork",
"trustedNetList": "Disabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/protectednetworks/{name}
Updates the configuration for the specified Protected Network. If the provided Protected Network data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/protectednetwork/protectednetwork.json",
"properties": {
"afTopologyHidingCfgSet": {
"description": "S9 AF/pCSCF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"hssTopologyHidingCfgSet": {
"description": "S6a/S6d HSS Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mmeTopologyHidingCfgSet": {
"description": "MME/SGSN Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pathTopologyHidingCfgSet": {
"description": "Path Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcrfTopologyHidingCfgSet": {
"description": "S9 PCRF Topology Hiding Configuration Set name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"protectedRealm": {
"description": "Name for Protected Network Realm, which must be unique within the DSR site. Protected Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"trustedNetList": {
"description": "Trusted Network List name for this Protected Network.",
"minLength": 0,
"maxLength": 32,
"default": "Disabled",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"protectedRealm"
],
"type": "object"
}
Example
{
"afTopologyHidingCfgSet": "MmiTestAfTopologyHidingCfgSet",
"hssTopologyHidingCfgSet": "Disabled",
"mmeTopologyHidingCfgSet": "MmiTestMmeTopologyHidingCfgSet",
"pathTopologyHidingCfgSet": "MmiTestPathTopologyHidingCfgSet",
"pcrfTopologyHidingCfgSet": "Disabled",
"protectedRealm": "MmiTestProtectedNetwork",
"trustedNetList": "Disabled"
}
delete /diameter/protectednetworks/{name}
Deletes the specified Protected Network from the NOAM configuration. A Protected Network can only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Rate Limiting Configuration Sets
Rate Limiting Configuration Sets provide the mechanism to enter configuration data needed by Egress Throttle Groups (ETGs) (/diameter/egressthrottlegroups) (on the SOAM) and Egress Throttle Lists (ETLs) (/diameter/egressthrottlelists) (on the NOAM) to perform egress throttling by egress message rate.
Rate Limiting Configuration Sets can be configured at either the NOAM or the SOAM. When configured at the NOAM, the Rate Limiting Configuration Set can be applied to any ETL also configured at the NOAM. When configured at the SOAM, the Rate Limiting Configuration Set can be applied to any ETG also configured at the same SOAM. Under no circumstance can a Rate Limiting Configuration Set configured at the NOAM be assigned to an ETG, nor can a Configuration Set configured at an SOAM be assigned to an ETL.
/diameter/ratelimitingconfigurationsets
get /diameter/ratelimitingconfigurationsets
Returns all Rate Limiting Configuration Sets configured at the NOAM or SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Rate Limiting Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Servers: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/ratelimitingconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ratelimitingconfigurationset/ratelimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxRate": {
"description": "The maximum allowed egress request rate shared by associated members. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Rate Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Rate Limiting Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateAbateThresh1": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"rateAbateThresh2": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"rateAbateThresh3": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"rateAbateTime": {
"description": "The time, in milliseconds, the egress request rate must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"rateConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"rateOnsetThresh1": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"rateOnsetThresh2": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"rateOnsetThresh3": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxRate",
"name",
"rateOnsetThresh1",
"rateAbateTime",
"rateAbateThresh1",
"rateConvergenceTime"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "47",
"maxRate": 6000,
"name": "RateLimitingConfigurationSet1",
"rateAbateThresh1": 55,
"rateAbateThresh2": 65,
"rateAbateThresh3": 80,
"rateAbateTime": 50,
"rateConvergenceTime": 250,
"rateOnsetThresh1": 60,
"rateOnsetThresh2": 70,
"rateOnsetThresh3": 90
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/ratelimitingconfigurationsets
Adds a new Rate Limiting Configuration Set to the configuration of the NOAM or SOAM that receives the POST request. The new Rate Limiting Configuration Set name must be unique to the OAM server that receives the PSOT request.
Target Servers: NOAM or SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ratelimitingconfigurationset/ratelimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxRate": {
"description": "The maximum allowed egress request rate shared by associated members. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Rate Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Rate Limiting Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateAbateThresh1": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"rateAbateThresh2": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"rateAbateThresh3": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"rateAbateTime": {
"description": "The time, in milliseconds, the egress request rate must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"rateConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"rateOnsetThresh1": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"rateOnsetThresh2": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"rateOnsetThresh3": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxRate",
"name",
"rateOnsetThresh1",
"rateAbateTime",
"rateAbateThresh1",
"rateConvergenceTime"
],
"type": "object"
}
Example
{
"configurationLevel": "47",
"maxRate": 6000,
"name": "RateLimitingConfigurationSet1",
"rateAbateThresh1": 55,
"rateAbateThresh2": 65,
"rateAbateThresh3": 80,
"rateAbateTime": 50,
"rateConvergenceTime": 250,
"rateOnsetThresh1": 60,
"rateOnsetThresh2": 70,
"rateOnsetThresh3": 90
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/ratelimitingconfigurationsets/{name}
get /diameter/ratelimitingconfigurationsets/{name}
Returns the configuration details for the Rate Limiting Configuration Set. If the Rate Limiting Configuration Set does not exist in the target SOAM's or NOAM's configuration, an error message is returned within the HTTP response.
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/ratelimitingconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ratelimitingconfigurationset/ratelimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxRate": {
"description": "The maximum allowed egress request rate shared by associated members. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Rate Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Rate Limiting Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateAbateThresh1": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"rateAbateThresh2": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"rateAbateThresh3": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"rateAbateTime": {
"description": "The time, in milliseconds, the egress request rate must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"rateConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"rateOnsetThresh1": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"rateOnsetThresh2": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"rateOnsetThresh3": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxRate",
"name",
"rateOnsetThresh1",
"rateAbateTime",
"rateAbateThresh1",
"rateConvergenceTime"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "47",
"maxRate": 6000,
"name": "RateLimitingConfigurationSet1",
"rateAbateThresh1": 55,
"rateAbateThresh2": 65,
"rateAbateThresh3": 80,
"rateAbateTime": 50,
"rateConvergenceTime": 250,
"rateOnsetThresh1": 60,
"rateOnsetThresh2": 70,
"rateOnsetThresh3": 90
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/ratelimitingconfigurationsets/{name}
Updates the configuration of the specified Rate Limiting Configuration Set.
Target Servers: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ratelimitingconfigurationset/ratelimitingconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxRate": {
"description": "The maximum allowed egress request rate shared by associated members. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"name": {
"description": "Name for the Rate Limiting Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Rate Limiting Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rateAbateThresh1": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh1, the congestion level is set to 0. Typical value is 55. Abatement Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 1,
"type": "integer"
},
"rateAbateThresh2": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh2, the congestion level is set to 1. Abatement Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 3,
"type": "integer"
},
"rateAbateThresh3": {
"description": "A percentage of maxRate. When the egress request rate falls below the rateAbateThresh3, the congestion level is set to 2. Abatement Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 99,
"minimum": 5,
"type": "integer"
},
"rateAbateTime": {
"description": "The time, in milliseconds, the egress request rate must remain below an abatement threshold before the Congestion Level is lowered. Typical value is 50.",
"maximum": 10000,
"minimum": 50,
"type": "integer"
},
"rateConvergenceTime": {
"description": "The time, in milliseconds, it takes to converge on a per second rate. If the convergence time is less than 1000 msec, the rate is extrapolated. If the convergence time is greater than 1000 msec, the rate is averaged. Typical value is 1000.",
"enum": [250, 500, 1000, 2000, 4000],
"type": "integer"
},
"rateOnsetThresh1": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh1, the congestion level is set to 1. Typical value is 60. Onset Threshold Level 1 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 2,
"type": "integer"
},
"rateOnsetThresh2": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh2, the congestion level is set to 2. Onset Threshold Level 2 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 4,
"type": "integer"
},
"rateOnsetThresh3": {
"description": "A percentage of maxRate. When the egress request rate exceeds the rateOnsetThresh3, the congestion level is set to 3. Onset Threshold Level 3 will be ignored if ETG Mode is Limit.",
"maximum": 100,
"minimum": 6,
"type": "integer"
}
},
"required": [
"maxRate",
"name",
"rateOnsetThresh1",
"rateAbateTime",
"rateAbateThresh1",
"rateConvergenceTime"
],
"type": "object"
}
Example
{
"configurationLevel": "47",
"maxRate": 6000,
"name": "RateLimitingConfigurationSet1",
"rateAbateThresh1": 55,
"rateAbateThresh2": 65,
"rateAbateThresh3": 80,
"rateAbateTime": 50,
"rateConvergenceTime": 250,
"rateOnsetThresh1": 60,
"rateOnsetThresh2": 70,
"rateOnsetThresh3": 90
}
delete /diameter/ratelimitingconfigurationsets/{name}
Deletes the specified Rate Limiting Configuration Set from the SOAM or NOAM configuration. A Rate Limiting Configuration Set can only be deleted if all delete validation checks pass. In general, if the Rate Limiting Configuration Set is part of the configuration of some other Managed Object, the Rate Limiting Configuration Set cannot be deleted. For example, if the Rate Limiting Configuration Set is named in an Egress Throttle Group (/diameter/egressthrottlegroups), the Rate Limiting Configuration Set must be removed from the Egress Throttle Group. Then the Rate Limiting Configuration Set can be deleted from the configuration. An attempt to delete a Rate Limiting Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Servers: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Reroute On Answer
Reroute On Answer controls where the DSR redirects an answer message. The action taken by the DSR in response to an answer message is based on the configured ordered pair of Application Id and Result-Code Attribute-Value Pair (AVP).
All Reroute On Answer configuration is done at the SOAM.
/diameter/reroutesonanswer
get /diameter/reroutesonanswer
Returns all Reroute On Answer values configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Reroute On Answer values meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/reroutesonanswerCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/reroutesonanswer/reroutesonanswer.json",
"properties": {
"ansResultCode": {
"description": "The Result-Code AVP value in the answer.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appId": {
"description": "The Application Id (/diameter/applicationid) in the answer identifying the Diameter Application. To include all Application Ids, set ruleAppliesToAllAppIds to true, the value for appId is ignored.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the Reroute On Answer instance (which has no name).",
"readOnly": true,
"maxLength": 21,
"type": "string"
},
"ruleAppliesToAllAppIds": {
"description": "When set to true, this Reroute on Answer instance applies to all Application Ids (/diameter/applicationids), and DSR ignores the specific appId value for this instance.",
"type": "boolean"
}
},
"required": [
"ansResultCode",
"ruleAppliesToAllAppIds"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"ansResultCode": 4292967295,
"appId": 4292967295,
"configurationLevel": "0",
"id": "4292967295-4292967295",
"ruleAppliesToAllAppIds": false
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/reroutesonanswer
Adds a new Reroute On Answer value to the DSR configuration. The new Reroute on Answer value must have an associated Application Id that is unique across all Reroute On Answer configurations.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/reroutesonanswer/reroutesonanswer.json",
"properties": {
"ansResultCode": {
"description": "The Result-Code AVP value in the answer.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appId": {
"description": "The Application Id (/diameter/applicationid) in the answer identifying the Diameter Application. To include all Application Ids, set ruleAppliesToAllAppIds to true, the value for appId is ignored.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the Reroute On Answer instance (which has no name).",
"readOnly": true,
"maxLength": 21,
"type": "string"
},
"ruleAppliesToAllAppIds": {
"description": "When set to true, this Reroute on Answer instance applies to all Application Ids (/diameter/applicationids), and DSR ignores the specific appId value for this instance.",
"type": "boolean"
}
},
"required": [
"ansResultCode",
"ruleAppliesToAllAppIds"
],
"type": "object"
}
Example
{
"ansResultCode": 4292967295,
"appId": 4292967295,
"configurationLevel": "0",
"id": "4292967295-4292967295",
"ruleAppliesToAllAppIds": false
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/reroutesonanswer/{id}
get /diameter/reroutesonanswer/{id}
Returns the configuration details for the specified Reroute On Answer value. If the specified Reroute On Answer value does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/reroutesonanswerItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/reroutesonanswer/reroutesonanswer.json",
"properties": {
"ansResultCode": {
"description": "The Result-Code AVP value in the answer.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"appId": {
"description": "The Application Id (/diameter/applicationid) in the answer identifying the Diameter Application. To include all Application Ids, set ruleAppliesToAllAppIds to true, the value for appId is ignored.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the Reroute On Answer instance (which has no name).",
"readOnly": true,
"maxLength": 21,
"type": "string"
},
"ruleAppliesToAllAppIds": {
"description": "When set to true, this Reroute on Answer instance applies to all Application Ids (/diameter/applicationids), and DSR ignores the specific appId value for this instance.",
"type": "boolean"
}
},
"required": [
"ansResultCode",
"ruleAppliesToAllAppIds"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ansResultCode": 4292967295,
"appId": 4292967295,
"configurationLevel": "0",
"id": "4292967295-4292967295",
"ruleAppliesToAllAppIds": false
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /diameter/reroutesonanswer/{id}
Deletes the specified Reroute On Answer value from the SOAM configuration. An attempt to delete a Reroute On Answer value that has already been deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Diameter: Reserved MCC Ranges
The MCC Ranges provide the range of the Reserved Mobile Country Code Range.
All Reserved MCC Range configuration is done at the SOAM.
/diameter/reservedmccranges
get /diameter/reservedmccranges
Returns all MCC Ranges configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those MCC Ranges meeting the request parameters are returned in the response.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/reservedmccrangeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/reservedmccrange/reservedmccrange.json",
"properties": {
"endMccRange": {
"description": "End MCC is the end value of the Reserved Mobile Country Code Range. Must be larger than Start MCC." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
},
"mccRangeId": {
"description": "The Mcc Range Id is the numeric value that acts as primary key in the table for update operation.",
"readOnly": true,
"maximum": 99999,
"minimum": 0,
"type": "integer"
},
"startMccRange": {
"description": "Start MCC is the start value of the Reserved Mobile Country Code Range." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
}
},
"required": [
"endMccRange",
"startMccRange"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"endMccRange": 41,
"startMccRange": 11
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/reservedmccranges
Adds a new MCC Range to the RBAR configuration. The Start Address and End Address for MCC Range shall not be overlapping or shall not already exists in the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/reservedmccrange/reservedmccrange.json",
"properties": {
"endMccRange": {
"description": "End MCC is the end value of the Reserved Mobile Country Code Range. Must be larger than Start MCC." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
},
"mccRangeId": {
"description": "The Mcc Range Id is the numeric value that acts as primary key in the table for update operation.",
"readOnly": true,
"maximum": 99999,
"minimum": 0,
"type": "integer"
},
"startMccRange": {
"description": "Start MCC is the start value of the Reserved Mobile Country Code Range." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
}
},
"required": [
"endMccRange",
"startMccRange"
],
"type": "object"
}
Example
{
"endMccRange": 41,
"startMccRange": 11
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/reservedmccranges/{name}
get /diameter/reservedmccranges/{name}
Returns the configuration details for the specified MCC Range. If the specified MCC Range does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/reservedmccrangeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/reservedmccrange/reservedmccrange.json",
"properties": {
"endMccRange": {
"description": "End MCC is the end value of the Reserved Mobile Country Code Range. Must be larger than Start MCC." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
},
"mccRangeId": {
"description": "The Mcc Range Id is the numeric value that acts as primary key in the table for update operation.",
"readOnly": true,
"maximum": 99999,
"minimum": 0,
"type": "integer"
},
"startMccRange": {
"description": "Start MCC is the start value of the Reserved Mobile Country Code Range." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
}
},
"required": [
"endMccRange",
"startMccRange"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"endMccRange": 41,
"startMccRange": 11
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/reservedmccranges/{name}
Updates the configuration for the specified MCC Range. If the provided MCC Range data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/reservedmccrange/reservedmccrange.json",
"properties": {
"endMccRange": {
"description": "End MCC is the end value of the Reserved Mobile Country Code Range. Must be larger than Start MCC." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
},
"mccRangeId": {
"description": "The Mcc Range Id is the numeric value that acts as primary key in the table for update operation.",
"readOnly": true,
"maximum": 99999,
"minimum": 0,
"type": "integer"
},
"startMccRange": {
"description": "Start MCC is the start value of the Reserved Mobile Country Code Range." ,
"maximum": 999,
"minimum": 0,
"type": "integer"
}
},
"required": [
"endMccRange",
"startMccRange"
],
"type": "object"
}
Example
{
"endMccRange": 41,
"startMccRange": 11
}
delete /diameter/reservedmccranges/{name}
Deletes the specified MCC Range from the SOAM configuration. A MCC Range will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Rf Message Copy
A Rf Message Copy list the APNs that need message copy to the diameter MPN Proxy Peer.
All Rf Message Copy configuration is done at the SOAM.
/diameter/rfmessagecopy
get /diameter/rfmessagecopy
Returns all Rf Message Copy configured at the SOAM that meet the criteria specified in a valid GET request.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/rfmessagecopyCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/rfmessagecopy/rfmessagecopy.json",
"properties": {
"apn": {
"description": "Access Point Name. Valid names are strings between 1 and 100 characters, inclusive. APN is a case-sensitive string. Valid characters are alphabetic characters (A-Z and a-z), digits (0-9), hyphen (-), and period (.). Must begin and end with an alphabetic character or a digit.",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
}
},
"required": [
"apn"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"apn": "testapn1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/rfmessagecopy
Adds a new Rf Message Copy to the DSR configuration. The new Rf Message Copy must have a name unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/rfmessagecopy/rfmessagecopy.json",
"properties": {
"apn": {
"description": "Access Point Name. Valid names are strings between 1 and 100 characters, inclusive. APN is a case-sensitive string. Valid characters are alphabetic characters (A-Z and a-z), digits (0-9), hyphen (-), and period (.). Must begin and end with an alphabetic character or a digit.",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
}
},
"required": [
"apn"
],
"type": "object"
}
Example
{
"apn": "testapn1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/rfmessagecopy/{apn}
get /diameter/rfmessagecopy/{apn}
Returns the configuration details for the specified Rf Message Copy. If the specified Rf Message Copy does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- apn: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/rfmessagecopyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/rfmessagecopy/rfmessagecopy.json",
"properties": {
"apn": {
"description": "Access Point Name. Valid names are strings between 1 and 100 characters, inclusive. APN is a case-sensitive string. Valid characters are alphabetic characters (A-Z and a-z), digits (0-9), hyphen (-), and period (.). Must begin and end with an alphabetic character or a digit.",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
}
},
"required": [
"apn"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"apn": "testapn1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /diameter/rfmessagecopy/{apn}
Deletes the specified Rf Message Copy from the SOAM configuration. Rf Message Copy is only deleted if all delete validation checks pass. An attempt to delete an Rf Message Copy that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- apn: required (string)
Diameter: Route Groups
A Route Group is a user-configured collection of either Peer Nodes (/diameter/peernodes) or Connections (/diameter/connections) which is used to determine the distribution of traffic within the Route Group. Traffic is distributed among available Peer Nodes (for a Peer Route Group) or Connections (for a Connection Route Group) based on the configured weight (also known as provisioned capacity) assigned to each Peer Node or Connection.
Using a Peer Route Group as an example, if Peer Node A has a configured weight of 100 and Peer Node B has a configured weight of 150, then 40% of the messages handled by the Route Group will be forwarded to Peer Node A, while the remaining 60% will be forwarded to Peer Node B.
All Route Group configuration is done at the SOAM.
/diameter/routegroups
get /diameter/routegroups
Returns all Route Groups configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Route Groups meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/routegroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routegroup/routegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connection": {
"description": "The list of Connections (/diameter/connections) associated with a Connection Route Group. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties": {
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionWeight": {
"description": "Weight assigned to this Connection (/diameter/connections). Traffic is distributed to available Connections within a Connection Route Group proportional to the Connection's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"connectionName",
"connectionWeight"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Route Group was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"isTrafficMeasuringEnabled": {
"description": "If true, traffic measurements are pegged for this Route Group. If false, traffic measurements are not pegged for this Route Group. Typical value is false.",
"type": "boolean"
},
"name": {
"description": "Name for the Route Group, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "The list of Peer Nodes (/diameter/peernodes) associated with Route Group of type Peer. When the value of type is Peer, then peerNode must be a list of 1 to 160 configured Peer Nodes and their desired weights, and connection should be omitted.",
"items": {
"properties": {
"peerNodeName": {
"description": "Name of a configured Peer Node (/diameter/peernodes).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeWeight": {
"description": "Weight assigned to this Peer Node (/diameter/peernodes). Traffic is distributed to available Peer Nodes within a Peer Route Group proportional to the Peer Node's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"peerNodeName",
"peerNodeWeight"
],
"type": "object"
},
"maxItems": 160,
"type": "array"
},
"type": {
"description": "A Route Group is configured as a set of either: 1) Peers Nodes (/diameter/peernodes), or 2) Connections (/diameter/connections) that have the same priority within the Route Group's parent Route List(s) (/diameter/routelists).",
"enum": [
"Peer",
"Connection"
],
"type": "string"
}
},
"required": [
"name",
"type"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "routeGroup1",
"type": "Connection",
"isTrafficMeasuringEnabled": false,
"connection": [
{
"connectionName": "Connection1",
"connectionWeight": 2
},
{
"connectionName": "Connection2",
"connectionWeight": 27
},
{
"connectionName": "Connection3",
"connectionWeight": 300
},
{
"connectionName": "Connection14",
"connectionWeight": 2457
}
],
"isDynamic": false
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/routegroups
Adds a new Route Group to the DSR configuration. The new Route Group must have a name that is unique across all Route Groups at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routegroup/routegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connection": {
"description": "The list of Connections (/diameter/connections) associated with a Connection Route Group. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties": {
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionWeight": {
"description": "Weight assigned to this Connection (/diameter/connections). Traffic is distributed to available Connections within a Connection Route Group proportional to the Connection's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"connectionName",
"connectionWeight"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Route Group was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"isTrafficMeasuringEnabled": {
"description": "If true, traffic measurements are pegged for this Route Group. If false, traffic measurements are not pegged for this Route Group. Typical value is false.",
"type": "boolean"
},
"name": {
"description": "Name for the Route Group, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "The list of Peer Nodes (/diameter/peernodes) associated with Route Group of type Peer. When the value of type is Peer, then peerNode must be a list of 1 to 160 configured Peer Nodes and their desired weights, and connection should be omitted.",
"items": {
"properties": {
"peerNodeName": {
"description": "Name of a configured Peer Node (/diameter/peernodes).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeWeight": {
"description": "Weight assigned to this Peer Node (/diameter/peernodes). Traffic is distributed to available Peer Nodes within a Peer Route Group proportional to the Peer Node's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"peerNodeName",
"peerNodeWeight"
],
"type": "object"
},
"maxItems": 160,
"type": "array"
},
"type": {
"description": "A Route Group is configured as a set of either: 1) Peers Nodes (/diameter/peernodes), or 2) Connections (/diameter/connections) that have the same priority within the Route Group's parent Route List(s) (/diameter/routelists).",
"enum": [
"Peer",
"Connection"
],
"type": "string"
}
},
"required": [
"name",
"type"
],
"type": "object"
}
Example
{
"name": "routeGroup1",
"type": "Connection",
"isTrafficMeasuringEnabled": false,
"connection": [
{
"connectionName": "Connection1",
"connectionWeight": 2
},
{
"connectionName": "Connection2",
"connectionWeight": 27
},
{
"connectionName": "Connection3",
"connectionWeight": 300
},
{
"connectionName": "Connection14",
"connectionWeight": 2457
}
],
"isDynamic": false
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/routegroups/status
get /diameter/routegroups/status
Returns the status of all Route Groups that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings can be filtered using only EQUAL. The route group name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE, while the Time of Last Update can be filtered using only EQUAL or NOT_EQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
Returns the status of all Route Groups that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings can be filtered using only EQUAL. The route group name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE, while the Time of Last Update can be filtered using only EQUAL or NOT_EQUAL.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=Enabled
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/routegroupstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routegroup/routegroupstatus.json",
"properties": {
"connection": {
"description": "The list of Connections (/diameter/connections) associated with a Connection Route Group. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties": {
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"connectionProvWeight": {
"description": "For a connection route group, it is the provisioned capacity of that particular connection in the route group.",
"maximum": 512,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"connectionStatus": {
"description": "Tells connections status. When Available is specified, the available capacity is greater than the minimum capacity. When Degraded is specified, the available capacity is greater than zero, but less than the provisioned capacity. When Unavailable is specified, the available capacity is zero. When Unk is specified, status information is not available in the database.",
"enum": [
"Available",
"Degraded",
"Unavailable",
"Unk"
],
"readOnly": true,
"type": "string"
},
"connectionTimeOfLastUpdate": {
"description": "The date/time the status for this connection specific Route Group Table was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"readOnly": true,
"type": "string"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For a multiple active DA-MP configuration, the MP leader always reports the route group status.For an active/standby DA-MP configuration, the active DA-MP reports the route group status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
}
},
"required": [
"connectionName",
"connectionProvWeight",
"connectionStatus"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Route Group was created dynamically as a result of dynamic peer discovery.",
"readOnly": true,
"type": "boolean"
},
"isTrafficMeasuringEnabled": {
"description": "Traffic measurement can be enabled or disabled for a peer route group. Up to 250 route groups can be enabled (including peer and connection route groups). When enabled, this field measures how many request and answer messages are successfully forwarded and received to and from route groups.",
"readOnly": true,
"type": "boolean"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For a multiple active DA-MP configuration, the MP leader always reports the route group status.For an active/standby DA-MP configuration, the active DA-MP reports the route group status.",
"maxLength": 30,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNode": {
"description": "The list of Peer Nodes (/diameter/peernodes) associated with Route Group of type Peer. When the value of type is Peer, then peerNode must be a list of 1 to 160 configured Peer Nodes and their desired weights, and connection should be omitted.",
"items": {
"properties": {
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For a multiple active DA-MP configuration, the MP leader always reports the route group status.For an active/standby DA-MP configuration, the active DA-MP reports the route group status.",
"maxLength": 30,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerAvailPercent": {
"description": "The percentage of capacity the peer node currently has compared to the total available capacity of all peer nodes in the route group.",
"maximum": 100,
"minimum": 0,
"readOnly": true,
"type": "float"
},
"peerAvailWeight": {
"description": "For a peer route group, it is the available capacity of that particular peer node in the route group.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"peerNodeName": {
"description": "Name of a configured Peer Node (/diameter/peernodes).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNodeStatus": {
"description": "Tells peer node status. When Available is specified, the available capacity is greater than the minimum capacity. When Degraded is specified, the available capacity is greater than zero, but less than the provisioned capacity. When Unavailable is specified, the available capacity is zero. When Unk is specified, status information is not available in the database.",
"enum": [
"Available",
"Degraded",
"Unavailable",
"Unk"
],
"readOnly": true,
"type": "string"
},
"peerProvPercent": {
"description": "The percentage of capacity assigned to each peer node/connection compared to all peer nodes/connections in the route group.",
"maximum": 100,
"minimum": 0,
"readOnly": true,
"type": "float"
},
"peerProvWeight": {
"description": "For a peer route group, it is the provisioned capacity of that particular peer node in the route group.",
"maximum": 160,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"peerTimeOfLastUpdate": {
"description": "The date/time the status for this peer specific Route Group Table was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"peerNodeName",
"peerNodeStatus",
"peerProvWeight"
],
"type": "object"
},
"maxItems": 160,
"readOnly": true,
"type": "array"
},
"routeGrpAvailWeight": {
"description": "For a peer route group, the sum total of the available capacity of all the peer nodes in the route group.For a connection route group, the sum total of available capacity of all the connections in the route group.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"routeGrpName": {
"description": "Route Group name is the name configured through /diameter/routegroups, which must be unique within the DSR site.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"routeGrpProvWeight": {
"description": "For a peer route group, the sum total of the provisioned capacity of all the peer nodes in the route group.For a connection route group, the sum total of the provisioned capacity of all the connections in the route group.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection/Peer Status are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection/Peer. If the OAM has current status for this Connection Status, statusKnown is set to true.",
"type": "boolean"
},
"type": {
"description": "A Route Group is configured as a set of either: 1) Peers Nodes (/diameter/peernodes), or 2) Connections (/diameter/connections) that have the same priority within the Route Group's parent Route List(s) (/diameter/routelists).",
"enum": [
"Peer",
"Connection"
],
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"isDynamic": false,
"isTrafficMeasuringEnabled": false,
"mpServerHostName": "MP1",
"peerNode": [
{
"mpServerHostName": "MP1",
"peerAvailPercent": 0,
"peerAvailWeight": 0,
"peerNodeName": "hss",
"peerNodeStatus": "Unavailable",
"peerProvPercent": 50,
"peerProvWeight": 1,
"peerTimeOfLastUpdate": "2018-Mar-05 11:05:05 EDT"
}
],
"routeGrpName": "routeGroup1",
"routeGrpAvailWeight": 0,
"routeGrpProvWeight": 60,
"statusKnown": true,
"type": "Peer"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/routegroups/{name}
get /diameter/routegroups/{name}
Returns the configuration details for the specified Route Group. If the specified Route Group does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/routegroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routegroup/routegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connection": {
"description": "The list of Connections (/diameter/connections) associated with a Connection Route Group. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties": {
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionWeight": {
"description": "Weight assigned to this Connection (/diameter/connections). Traffic is distributed to available Connections within a Connection Route Group proportional to the Connection's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"connectionName",
"connectionWeight"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Route Group was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"isTrafficMeasuringEnabled": {
"description": "If true, traffic measurements are pegged for this Route Group. If false, traffic measurements are not pegged for this Route Group. Typical value is false.",
"type": "boolean"
},
"name": {
"description": "Name for the Route Group, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "The list of Peer Nodes (/diameter/peernodes) associated with Route Group of type Peer. When the value of type is Peer, then peerNode must be a list of 1 to 160 configured Peer Nodes and their desired weights, and connection should be omitted.",
"items": {
"properties": {
"peerNodeName": {
"description": "Name of a configured Peer Node (/diameter/peernodes).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeWeight": {
"description": "Weight assigned to this Peer Node (/diameter/peernodes). Traffic is distributed to available Peer Nodes within a Peer Route Group proportional to the Peer Node's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"peerNodeName",
"peerNodeWeight"
],
"type": "object"
},
"maxItems": 160,
"type": "array"
},
"type": {
"description": "A Route Group is configured as a set of either: 1) Peers Nodes (/diameter/peernodes), or 2) Connections (/diameter/connections) that have the same priority within the Route Group's parent Route List(s) (/diameter/routelists).",
"enum": [
"Peer",
"Connection"
],
"type": "string"
}
},
"required": [
"name",
"type"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "routeGroup1",
"type": "Connection",
"isTrafficMeasuringEnabled": false,
"connection": [
{
"connectionName": "Connection1",
"connectionWeight": 2
},
{
"connectionName": "Connection2",
"connectionWeight": 27
},
{
"connectionName": "Connection3",
"connectionWeight": 300
},
{
"connectionName": "Connection14",
"connectionWeight": 2457
}
],
"isDynamic": false
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/routegroups/{name}
Updates the configuration for the specified Route Group. If the provided Route Group data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routegroup/routegroup.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connection": {
"description": "The list of Connections (/diameter/connections) associated with a Connection Route Group. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties": {
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionWeight": {
"description": "Weight assigned to this Connection (/diameter/connections). Traffic is distributed to available Connections within a Connection Route Group proportional to the Connection's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"connectionName",
"connectionWeight"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Route Group was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"isTrafficMeasuringEnabled": {
"description": "If true, traffic measurements are pegged for this Route Group. If false, traffic measurements are not pegged for this Route Group. Typical value is false.",
"type": "boolean"
},
"name": {
"description": "Name for the Route Group, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNode": {
"description": "The list of Peer Nodes (/diameter/peernodes) associated with Route Group of type Peer. When the value of type is Peer, then peerNode must be a list of 1 to 160 configured Peer Nodes and their desired weights, and connection should be omitted.",
"items": {
"properties": {
"peerNodeName": {
"description": "Name of a configured Peer Node (/diameter/peernodes).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeWeight": {
"description": "Weight assigned to this Peer Node (/diameter/peernodes). Traffic is distributed to available Peer Nodes within a Peer Route Group proportional to the Peer Node's assigned weight.",
"maximum": 65535,
"minimum": 1,
"type": "integer"
}
},
"required": [
"peerNodeName",
"peerNodeWeight"
],
"type": "object"
},
"maxItems": 160,
"type": "array"
},
"type": {
"description": "A Route Group is configured as a set of either: 1) Peers Nodes (/diameter/peernodes), or 2) Connections (/diameter/connections) that have the same priority within the Route Group's parent Route List(s) (/diameter/routelists).",
"enum": [
"Peer",
"Connection"
],
"type": "string"
}
},
"required": [
"name",
"type"
],
"type": "object"
}
Example
{
"name": "routeGroup1",
"type": "Connection",
"isTrafficMeasuringEnabled": false,
"connection": [
{
"connectionName": "Connection1",
"connectionWeight": 2
},
{
"connectionName": "Connection2",
"connectionWeight": 27
},
{
"connectionName": "Connection3",
"connectionWeight": 300
},
{
"connectionName": "Connection14",
"connectionWeight": 2457
}
],
"isDynamic": false
}
delete /diameter/routegroups/{name}
Deletes the specified Route Group from the SOAM configuration. A Route Group will only be deleted if all delete validation checks pass. In general, if the Route Group is part of the configuration of some other Managed Object, the Route Group cannot be deleted. For example, if the Route Group is named in a Route List (/diameter/routelists), the Route Group must first be removed from the Route List. Then the Route Group can be deleted from the configuration. An attempt to delete a Route Group that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/diameter/routegroups/{name}/status
get /diameter/routegroups/{name}/status
Retrieves the operational status for the specified Route Group.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/routegroupstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routegroup/routegroupstatus.json",
"properties": {
"connection": {
"description": "The list of Connections (/diameter/connections) associated with a Connection Route Group. If the value of type is Connection, then connection must be a list of 1 to 512 configured Connections and their desired weights, and peerNode should be omitted.",
"items": {
"properties": {
"connectionName": {
"description": "Name of a configured Connection (/diameter/connections).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"connectionProvWeight": {
"description": "For a connection route group, it is the provisioned capacity of that particular connection in the route group.",
"maximum": 512,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"connectionStatus": {
"description": "Tells connections status. When Available is specified, the available capacity is greater than the minimum capacity. When Degraded is specified, the available capacity is greater than zero, but less than the provisioned capacity. When Unavailable is specified, the available capacity is zero. When Unk is specified, status information is not available in the database.",
"enum": [
"Available",
"Degraded",
"Unavailable",
"Unk"
],
"readOnly": true,
"type": "string"
},
"connectionTimeOfLastUpdate": {
"description": "The date/time the status for this connection specific Route Group Table was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"readOnly": true,
"type": "string"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For a multiple active DA-MP configuration, the MP leader always reports the route group status.For an active/standby DA-MP configuration, the active DA-MP reports the route group status.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"readOnly": true,
"type": "string"
}
},
"required": [
"connectionName",
"connectionProvWeight",
"connectionStatus"
],
"type": "object"
},
"maxItems": 512,
"type": "array"
},
"isDynamic": {
"description": "If true, means the Route Group was created dynamically as a result of dynamic peer discovery.",
"readOnly": true,
"type": "boolean"
},
"isTrafficMeasuringEnabled": {
"description": "Traffic measurement can be enabled or disabled for a peer route group. Up to 250 route groups can be enabled (including peer and connection route groups). When enabled, this field measures how many request and answer messages are successfully forwarded and received to and from route groups.",
"readOnly": true,
"type": "boolean"
},
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For a multiple active DA-MP configuration, the MP leader always reports the route group status.For an active/standby DA-MP configuration, the active DA-MP reports the route group status.",
"maxLength": 30,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNode": {
"description": "The list of Peer Nodes (/diameter/peernodes) associated with Route Group of type Peer. When the value of type is Peer, then peerNode must be a list of 1 to 160 configured Peer Nodes and their desired weights, and connection should be omitted.",
"items": {
"properties": {
"mpServerHostName": {
"description": "Hostname of MP server from which status is reported. For a multiple active DA-MP configuration, the MP leader always reports the route group status.For an active/standby DA-MP configuration, the active DA-MP reports the route group status.",
"maxLength": 30,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerAvailPercent": {
"description": "The percentage of capacity the peer node currently has compared to the total available capacity of all peer nodes in the route group.",
"maximum": 100,
"minimum": 0,
"readOnly": true,
"type": "float"
},
"peerAvailWeight": {
"description": "For a peer route group, it is the available capacity of that particular peer node in the route group.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"peerNodeName": {
"description": "Name of a configured Peer Node (/diameter/peernodes).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"peerNodeStatus": {
"description": "Tells peer node status. When Available is specified, the available capacity is greater than the minimum capacity. When Degraded is specified, the available capacity is greater than zero, but less than the provisioned capacity. When Unavailable is specified, the available capacity is zero. When Unk is specified, status information is not available in the database.",
"enum": [
"Available",
"Degraded",
"Unavailable",
"Unk"
],
"readOnly": true,
"type": "string"
},
"peerProvPercent": {
"description": "The percentage of capacity assigned to each peer node/connection compared to all peer nodes/connections in the route group.",
"maximum": 100,
"minimum": 0,
"readOnly": true,
"type": "float"
},
"peerProvWeight": {
"description": "For a peer route group, it is the provisioned capacity of that particular peer node in the route group.",
"maximum": 160,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"peerTimeOfLastUpdate": {
"description": "The date/time the status for this peer specific Route Group Table was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"readOnly": true,
"type": "string"
}
},
"required": [
"peerNodeName",
"peerNodeStatus",
"peerProvWeight"
],
"type": "object"
},
"maxItems": 160,
"readOnly": true,
"type": "array"
},
"routeGrpAvailWeight": {
"description": "For a peer route group, the sum total of the available capacity of all the peer nodes in the route group.For a connection route group, the sum total of available capacity of all the connections in the route group.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"routeGrpName": {
"description": "Route Group name is the name configured through /diameter/routegroups, which must be unique within the DSR site.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"routeGrpProvWeight": {
"description": "For a peer route group, the sum total of the provisioned capacity of all the peer nodes in the route group.For a connection route group, the sum total of the provisioned capacity of all the connections in the route group.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection/Peer Status are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Connection/Peer. If the OAM has current status for this Connection Status, statusKnown is set to true.",
"type": "boolean"
},
"type": {
"description": "A Route Group is configured as a set of either: 1) Peers Nodes (/diameter/peernodes), or 2) Connections (/diameter/connections) that have the same priority within the Route Group's parent Route List(s) (/diameter/routelists).",
"enum": [
"Peer",
"Connection"
],
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"isDynamic": false,
"isTrafficMeasuringEnabled": false,
"mpServerHostName": "MP1",
"peerNode": [
{
"mpServerHostName": "MP1",
"peerAvailPercent": 0,
"peerAvailWeight": 0,
"peerNodeName": "hss",
"peerNodeStatus": "Unavailable",
"peerProvPercent": 50,
"peerProvWeight": 1,
"peerTimeOfLastUpdate": "2018-Mar-05 11:05:05 EDT"
}
],
"routeGrpName": "routeGroup1",
"routeGrpAvailWeight": 0,
"routeGrpProvWeight": 60,
"statusKnown": true,
"type": "Peer"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Route Lists
A Route List is a user-configured collection of one to three Route Groups (/diameter/routegroups), which is used when selecting an egress Connection (/diameter/connections) for a message received by the DSR. Route Lists are part of the load sharing and balancing mechanism the DSR supplies in its mission as a router of Diameter and RADIUS messages. If the current available capacity of a Route Group meets or exceeds the Minimum Route Group Availability Weight assigned to the Route List, that Route Group is considered Available, and is a candidate to be selected when the routing decision is made. Any Route Group whose current available capacity is less than the Minimum Route Group Availability Weight is considered Degraded, and can still be selected for routing if other conditions are met (e.g., the absence of any Route Group that is currently Available). Any Route Group whose current available capacity is zero is considered Prohibited, and cannot be selected for routing.
All Route List configuration is done at the SOAM.
/diameter/routelists
get /diameter/routelists
Returns all Route Lists configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Route Lists meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/routelistCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routelist/routelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"isDynamic": {
"description": "If true, means the Route List was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"minCapacity": {
"description": "Also known as Minimum Route Group Availability Weight, minCapacity is a threshold that defines whether a Route Group (/diameter/routegroups) is considered Available. If the current available capacity of all the Peer Nodes (/diameter/peernodes) or Connections (/diameter/connections) in a Route Group is greater than or equal to minCapacity, then that Route Group is considered to be Available. If the current available capacity of all the Peer Nodes or Connections is less than minCapacity, but greater than zero, then the Route Group is considered to be Degraded. Available or Degraded Route Groups can be selected by the DSR's routing algorithm when the DSR chooses an egress Connection on which to route a Diameter or RADIUS message. The current available capacity of all the Peer Nodes or Connections is zero, the Route Group is considered Prohibited and cannot be selected for routing.",
"maximum": 1024000,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Route List, which must be unique within the DSR site. A name is required, and cannot be changed after the Route List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rarg": {
"description": "Route Across Route Groups. For each message to be routed, DSR chooses one of the Route Groups (/diameter/routegroups) configured in this Route List as the primary, and attempts to route the message over one or more Connections (/diameter/connections) within that primary Route Group. If the message cannot be successfully routed via the primary Route Group, and rarg is set to true, then a different Route Group can be selected (assuming more than one Route Group is configured). If rarg is set to false and routing via the primary Route Group fails, then the routing of that message fails.",
"type": "boolean"
},
"routeListRouteGroup": {
"description": "The Route Groups (/diameter/routegroups) associated with this Route List. A Route List must have between one and three Route Groups configured to it.",
"items": {
"properties": {
"priority": {
"description": "The priority of this Route Group (/diameter/routegroups) within the Route List. A value of 1 indicates the highest priority Route Group, while a value of 3 indicates the lowest priority Route Group.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"routeGroupName": {
"description": "Name of a Route Group (/diameter/routegroups) configured to the same SOAM as the Route List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeListRouteGroupTtg": {
"description": "Each Route Group (/diameter/routegroups) within a Route List can have zero to ten TTGs (/diameter/trafficthrottlegroups) associated with it.",
"items": {
"description": "A single TTG (/diameter/trafficthrottlegroups) and its loss percent threshold associated with this Route List/Route Group (/diameter/routegroups) pair. A TTG can be configured either at the same site (known as a Local TTG) or at a different site (known as a Shared TTG).",
"properties": {
"lossPercentThreshold": {
"description": "Whenever the current computed loss percentage for the TTG (/diameter/trafficthrottlegroups) named in ttgName exceeds this configured lossPercentThreshold, the DSR does not forward Diameter messages to the Route Group (/diameter/routegroups) specified by routeGroupName.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this TTG (/diameter/trafficthrottlegroups). If siteName is the same site at which this Route List is being configured, the TTG is known as a Local TTG. If siteName is a site other than where this Route List is being configured, the TTG is known as a Shared TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttgName": {
"description": "Name of a TTG (/diameter/trafficthrottlegroups) configured at the site named by siteName.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"siteName",
"ttgName",
"lossPercentThreshold"
],
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
}
},
"required": [
"routeGroupName",
"priority"
],
"type": "object"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
}
},
"required": [
"name",
"minCapacity",
"rarg",
"routeListRouteGroup"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "5200",
"isDynamic": false,
"minCapacity": 100000,
"name": "clientRouteList4",
"rarg": false,
"routeListRouteGroup":
[{
"priority": 1,
"routeGroupName": "clientRouteGroup1",
"routeListRouteGroupTtg":
[{
"lossPercentThreshold": 90,
"siteName": "dsrSite4",
"ttgName": "clientTtg1"
},
{
"lossPercentThreshold": 85,
"siteName": "dsrSite3",
"ttgName": "clientTtg2"
}]
},
{
"priority": 2,
"routeGroupName": "clientRouteGroup2"
}]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/routelists
Adds a new Route List to the DSR configuration. The new Route List must have a name that is unique across all Route Lists at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routelist/routelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"isDynamic": {
"description": "If true, means the Route List was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"minCapacity": {
"description": "Also known as Minimum Route Group Availability Weight, minCapacity is a threshold that defines whether a Route Group (/diameter/routegroups) is considered Available. If the current available capacity of all the Peer Nodes (/diameter/peernodes) or Connections (/diameter/connections) in a Route Group is greater than or equal to minCapacity, then that Route Group is considered to be Available. If the current available capacity of all the Peer Nodes or Connections is less than minCapacity, but greater than zero, then the Route Group is considered to be Degraded. Available or Degraded Route Groups can be selected by the DSR's routing algorithm when the DSR chooses an egress Connection on which to route a Diameter or RADIUS message. The current available capacity of all the Peer Nodes or Connections is zero, the Route Group is considered Prohibited and cannot be selected for routing.",
"maximum": 1024000,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Route List, which must be unique within the DSR site. A name is required, and cannot be changed after the Route List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rarg": {
"description": "Route Across Route Groups. For each message to be routed, DSR chooses one of the Route Groups (/diameter/routegroups) configured in this Route List as the primary, and attempts to route the message over one or more Connections (/diameter/connections) within that primary Route Group. If the message cannot be successfully routed via the primary Route Group, and rarg is set to true, then a different Route Group can be selected (assuming more than one Route Group is configured). If rarg is set to false and routing via the primary Route Group fails, then the routing of that message fails.",
"type": "boolean"
},
"routeListRouteGroup": {
"description": "The Route Groups (/diameter/routegroups) associated with this Route List. A Route List must have between one and three Route Groups configured to it.",
"items": {
"properties": {
"priority": {
"description": "The priority of this Route Group (/diameter/routegroups) within the Route List. A value of 1 indicates the highest priority Route Group, while a value of 3 indicates the lowest priority Route Group.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"routeGroupName": {
"description": "Name of a Route Group (/diameter/routegroups) configured to the same SOAM as the Route List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeListRouteGroupTtg": {
"description": "Each Route Group (/diameter/routegroups) within a Route List can have zero to ten TTGs (/diameter/trafficthrottlegroups) associated with it.",
"items": {
"description": "A single TTG (/diameter/trafficthrottlegroups) and its loss percent threshold associated with this Route List/Route Group (/diameter/routegroups) pair. A TTG can be configured either at the same site (known as a Local TTG) or at a different site (known as a Shared TTG).",
"properties": {
"lossPercentThreshold": {
"description": "Whenever the current computed loss percentage for the TTG (/diameter/trafficthrottlegroups) named in ttgName exceeds this configured lossPercentThreshold, the DSR does not forward Diameter messages to the Route Group (/diameter/routegroups) specified by routeGroupName.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this TTG (/diameter/trafficthrottlegroups). If siteName is the same site at which this Route List is being configured, the TTG is known as a Local TTG. If siteName is a site other than where this Route List is being configured, the TTG is known as a Shared TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttgName": {
"description": "Name of a TTG (/diameter/trafficthrottlegroups) configured at the site named by siteName.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"siteName",
"ttgName",
"lossPercentThreshold"
],
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
}
},
"required": [
"routeGroupName",
"priority"
],
"type": "object"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
}
},
"required": [
"name",
"minCapacity",
"rarg",
"routeListRouteGroup"
],
"type": "object"
}
Example
{
"configurationLevel": "5200",
"isDynamic": false,
"minCapacity": 100000,
"name": "clientRouteList4",
"rarg": false,
"routeListRouteGroup":
[{
"priority": 1,
"routeGroupName": "clientRouteGroup1",
"routeListRouteGroupTtg":
[{
"lossPercentThreshold": 90,
"siteName": "dsrSite4",
"ttgName": "clientTtg1"
},
{
"lossPercentThreshold": 85,
"siteName": "dsrSite3",
"ttgName": "clientTtg2"
}]
},
{
"priority": 2,
"routeGroupName": "clientRouteGroup2"
}]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/routelists/status
get /diameter/routelists/status
Returns the status of all Route List.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
Returns the status of all Route List that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings can be filtered using only EQUAL. The name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE, while the Time of Last Update can be filtered using only EQUAL or NOT_EQUAL.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=RouteListName
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/routeliststatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routelist/routeliststatus.json",
"properties": {
"activeStandby": {
"description": "A Route Group can be, Active: this is the Route Group that Diameter messages are actively being routed to.Standby: messages are not currently being routed to this Route Group, unless the Active Route Group is unavailable and Route Across Route Groups is enabled on the Route List.Unknown: information on this Route Group is not present in the database.",
"enum": [
"Active",
"Standby",
"Unknown"
],
"type": "string"
},
"isDynamic": {
"description": "If true, means the Route List was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"minCapacity": {
"description": "Also known as Minimum Route Group Availability Weight, minCapacity is a threshold that defines whether a Route Group (/diameter/routegroups) is considered Available. If the current available capacity of all the Peer Nodes (/diameter/peernodes) or Connections (/diameter/connections) in a Route Group is greater than or equal to minCapacity, then that Route Group is considered to be Available. If the current available capacity of all the Peer Nodes or Connections is less than minCapacity, but greater than zero, then the Route Group is considered to be Degraded. Available or Degraded Route Groups can be selected by the DSR's routing algorithm when the DSR chooses an egress Connection on which to route a Diameter or RADIUS message. The current available capacity of all the Peer Nodes or Connections is zero, the Route Group is considered Prohibited and cannot be selected for routing.",
"maximum": 1024000,
"minimum": 1,
"type": "integer"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the DA-MP server that is currently reporting the status of this Connection. For all three Fixed-type Connections (Initiator, Responder, Initiator & Responder) and IPFE Initiator Connections, mpServerHostname indicates the DA-MP that is configured to host the Connection. For Floating Connections that are established (IPFE Responder, IPFE Initiator & Responder Connections), mpServerHostname is the DA-MP on which the Connection became established. For Floating Connections that are not established, mpServerHostname is the DA-MP Leader, since it is the DA-MP Leader that reports status for un-established Floating Connections.",
"type": "string"
},
"name": {
"description": "Name for this Route List, which must be unique within the DSR site. A name is required, and cannot be changed after the Route List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"operationalStatus": {
"description": "Route List can be, Available: the available capacity of the Route Group is greater than the Minimum Route Group Availability Weight.Degraded: the available capacity of the Route Group is greater than zero, but less than the Minimum Route Group Availability Weight.Unavailable: the Route Group available capacity is zero.Unknown: status information is not available in the database.",
"enum": [
"Available",
"Degraded",
"Unavailable",
"Unknown"
],
"type": "string"
},
"priority": {
"description": "The priority of this Route Group (/diameter/routegroups) within the Route List. A value of 1 indicates the highest priority Route Group, while a value of 3 indicates the lowest priority Route Group.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"routeGroupName": {
"description": "Route Groups assigned to the Route List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this ETG are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this ETG. If the OAM has current status for this ETG, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "Time stamp that shows the last time the status information was updated.",
"pattern": "^[0-9]{4}[-][a-zA-Z]{3}[-][0-9]{2} [0-9]{2}[:][0-9]{2}[:][0-9]{2} .*$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"activeStandby": "Active",
"isDynamic": false,
"minCapacity": 100000,
"mpServerHostname": "MP1",
"name": "clientRouteList4",
"operationalStatus": "Available",
"priority": 1,
"routeGroupName": "clientRouteGroup1",
"statusKnown": true,
"timeOfLastUpdate": "2017-Aug-25 11:05:05 EDT"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/routelists/{name}
get /diameter/routelists/{name}
Returns the configuration details for the specified Route List. If the specified Route List does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/routelistItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routelist/routelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"isDynamic": {
"description": "If true, means the Route List was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"minCapacity": {
"description": "Also known as Minimum Route Group Availability Weight, minCapacity is a threshold that defines whether a Route Group (/diameter/routegroups) is considered Available. If the current available capacity of all the Peer Nodes (/diameter/peernodes) or Connections (/diameter/connections) in a Route Group is greater than or equal to minCapacity, then that Route Group is considered to be Available. If the current available capacity of all the Peer Nodes or Connections is less than minCapacity, but greater than zero, then the Route Group is considered to be Degraded. Available or Degraded Route Groups can be selected by the DSR's routing algorithm when the DSR chooses an egress Connection on which to route a Diameter or RADIUS message. The current available capacity of all the Peer Nodes or Connections is zero, the Route Group is considered Prohibited and cannot be selected for routing.",
"maximum": 1024000,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Route List, which must be unique within the DSR site. A name is required, and cannot be changed after the Route List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rarg": {
"description": "Route Across Route Groups. For each message to be routed, DSR chooses one of the Route Groups (/diameter/routegroups) configured in this Route List as the primary, and attempts to route the message over one or more Connections (/diameter/connections) within that primary Route Group. If the message cannot be successfully routed via the primary Route Group, and rarg is set to true, then a different Route Group can be selected (assuming more than one Route Group is configured). If rarg is set to false and routing via the primary Route Group fails, then the routing of that message fails.",
"type": "boolean"
},
"routeListRouteGroup": {
"description": "The Route Groups (/diameter/routegroups) associated with this Route List. A Route List must have between one and three Route Groups configured to it.",
"items": {
"properties": {
"priority": {
"description": "The priority of this Route Group (/diameter/routegroups) within the Route List. A value of 1 indicates the highest priority Route Group, while a value of 3 indicates the lowest priority Route Group.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"routeGroupName": {
"description": "Name of a Route Group (/diameter/routegroups) configured to the same SOAM as the Route List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeListRouteGroupTtg": {
"description": "Each Route Group (/diameter/routegroups) within a Route List can have zero to ten TTGs (/diameter/trafficthrottlegroups) associated with it.",
"items": {
"description": "A single TTG (/diameter/trafficthrottlegroups) and its loss percent threshold associated with this Route List/Route Group (/diameter/routegroups) pair. A TTG can be configured either at the same site (known as a Local TTG) or at a different site (known as a Shared TTG).",
"properties": {
"lossPercentThreshold": {
"description": "Whenever the current computed loss percentage for the TTG (/diameter/trafficthrottlegroups) named in ttgName exceeds this configured lossPercentThreshold, the DSR does not forward Diameter messages to the Route Group (/diameter/routegroups) specified by routeGroupName.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this TTG (/diameter/trafficthrottlegroups). If siteName is the same site at which this Route List is being configured, the TTG is known as a Local TTG. If siteName is a site other than where this Route List is being configured, the TTG is known as a Shared TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttgName": {
"description": "Name of a TTG (/diameter/trafficthrottlegroups) configured at the site named by siteName.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"siteName",
"ttgName",
"lossPercentThreshold"
],
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
}
},
"required": [
"routeGroupName",
"priority"
],
"type": "object"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
}
},
"required": [
"name",
"minCapacity",
"rarg",
"routeListRouteGroup"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "5200",
"isDynamic": false,
"minCapacity": 100000,
"name": "clientRouteList4",
"rarg": false,
"routeListRouteGroup":
[{
"priority": 1,
"routeGroupName": "clientRouteGroup1",
"routeListRouteGroupTtg":
[{
"lossPercentThreshold": 90,
"siteName": "dsrSite4",
"ttgName": "clientTtg1"
},
{
"lossPercentThreshold": 85,
"siteName": "dsrSite3",
"ttgName": "clientTtg2"
}]
},
{
"priority": 2,
"routeGroupName": "clientRouteGroup2"
}]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/routelists/{name}
Updates the configuration for the specified Route List. If the provided Route List data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routelist/routelist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"isDynamic": {
"description": "If true, means the Route List was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"minCapacity": {
"description": "Also known as Minimum Route Group Availability Weight, minCapacity is a threshold that defines whether a Route Group (/diameter/routegroups) is considered Available. If the current available capacity of all the Peer Nodes (/diameter/peernodes) or Connections (/diameter/connections) in a Route Group is greater than or equal to minCapacity, then that Route Group is considered to be Available. If the current available capacity of all the Peer Nodes or Connections is less than minCapacity, but greater than zero, then the Route Group is considered to be Degraded. Available or Degraded Route Groups can be selected by the DSR's routing algorithm when the DSR chooses an egress Connection on which to route a Diameter or RADIUS message. The current available capacity of all the Peer Nodes or Connections is zero, the Route Group is considered Prohibited and cannot be selected for routing.",
"maximum": 1024000,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Route List, which must be unique within the DSR site. A name is required, and cannot be changed after the Route List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"rarg": {
"description": "Route Across Route Groups. For each message to be routed, DSR chooses one of the Route Groups (/diameter/routegroups) configured in this Route List as the primary, and attempts to route the message over one or more Connections (/diameter/connections) within that primary Route Group. If the message cannot be successfully routed via the primary Route Group, and rarg is set to true, then a different Route Group can be selected (assuming more than one Route Group is configured). If rarg is set to false and routing via the primary Route Group fails, then the routing of that message fails.",
"type": "boolean"
},
"routeListRouteGroup": {
"description": "The Route Groups (/diameter/routegroups) associated with this Route List. A Route List must have between one and three Route Groups configured to it.",
"items": {
"properties": {
"priority": {
"description": "The priority of this Route Group (/diameter/routegroups) within the Route List. A value of 1 indicates the highest priority Route Group, while a value of 3 indicates the lowest priority Route Group.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"routeGroupName": {
"description": "Name of a Route Group (/diameter/routegroups) configured to the same SOAM as the Route List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeListRouteGroupTtg": {
"description": "Each Route Group (/diameter/routegroups) within a Route List can have zero to ten TTGs (/diameter/trafficthrottlegroups) associated with it.",
"items": {
"description": "A single TTG (/diameter/trafficthrottlegroups) and its loss percent threshold associated with this Route List/Route Group (/diameter/routegroups) pair. A TTG can be configured either at the same site (known as a Local TTG) or at a different site (known as a Shared TTG).",
"properties": {
"lossPercentThreshold": {
"description": "Whenever the current computed loss percentage for the TTG (/diameter/trafficthrottlegroups) named in ttgName exceeds this configured lossPercentThreshold, the DSR does not forward Diameter messages to the Route Group (/diameter/routegroups) specified by routeGroupName.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"siteName": {
"description": "The SOAM Server Group name of the site that owns this TTG (/diameter/trafficthrottlegroups). If siteName is the same site at which this Route List is being configured, the TTG is known as a Local TTG. If siteName is a site other than where this Route List is being configured, the TTG is known as a Shared TTG.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttgName": {
"description": "Name of a TTG (/diameter/trafficthrottlegroups) configured at the site named by siteName.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"siteName",
"ttgName",
"lossPercentThreshold"
],
"type": "object"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
}
},
"required": [
"routeGroupName",
"priority"
],
"type": "object"
},
"maxItems": 3,
"minItems": 1,
"type": "array"
}
},
"required": [
"name",
"minCapacity",
"rarg",
"routeListRouteGroup"
],
"type": "object"
}
Example
{
"configurationLevel": "5200",
"isDynamic": false,
"minCapacity": 100000,
"name": "clientRouteList4",
"rarg": false,
"routeListRouteGroup":
[{
"priority": 1,
"routeGroupName": "clientRouteGroup1",
"routeListRouteGroupTtg":
[{
"lossPercentThreshold": 90,
"siteName": "dsrSite4",
"ttgName": "clientTtg1"
},
{
"lossPercentThreshold": 85,
"siteName": "dsrSite3",
"ttgName": "clientTtg2"
}]
},
{
"priority": 2,
"routeGroupName": "clientRouteGroup2"
}]
}
delete /diameter/routelists/{name}
Deletes the specified Route List from the SOAM configuration. A Route List can only be deleted if all delete validation checks pass. In general, if the Route List is part of the configuration of some other Managed Object, the Route List cannot be deleted. For example, if the Route List is named by a Peer Route Rule (/diameter/peerrouterules), the Route List must first be removed from the Peer Route Rule. Then the Route List can be deleted from the configuration. An attempt to delete a Route List that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/diameter/routelists/{name}/status
get /diameter/routelists/{name}/status
Retrieves the operational status for the specified Route List.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/routeliststatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routelist/routeliststatus.json",
"properties": {
"activeStandby": {
"description": "A Route Group can be, Active: this is the Route Group that Diameter messages are actively being routed to.Standby: messages are not currently being routed to this Route Group, unless the Active Route Group is unavailable and Route Across Route Groups is enabled on the Route List.Unknown: information on this Route Group is not present in the database.",
"enum": [
"Active",
"Standby",
"Unknown"
],
"type": "string"
},
"isDynamic": {
"description": "If true, means the Route List was created dynamically as a result of dynamic peer discovery. isDynamic is read-only.",
"readOnly": true,
"type": "boolean"
},
"minCapacity": {
"description": "Also known as Minimum Route Group Availability Weight, minCapacity is a threshold that defines whether a Route Group (/diameter/routegroups) is considered Available. If the current available capacity of all the Peer Nodes (/diameter/peernodes) or Connections (/diameter/connections) in a Route Group is greater than or equal to minCapacity, then that Route Group is considered to be Available. If the current available capacity of all the Peer Nodes or Connections is less than minCapacity, but greater than zero, then the Route Group is considered to be Degraded. Available or Degraded Route Groups can be selected by the DSR's routing algorithm when the DSR chooses an egress Connection on which to route a Diameter or RADIUS message. The current available capacity of all the Peer Nodes or Connections is zero, the Route Group is considered Prohibited and cannot be selected for routing.",
"maximum": 1024000,
"minimum": 1,
"type": "integer"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the DA-MP server that is currently reporting the status of this Connection. For all three Fixed-type Connections (Initiator, Responder, Initiator & Responder) and IPFE Initiator Connections, mpServerHostname indicates the DA-MP that is configured to host the Connection. For Floating Connections that are established (IPFE Responder, IPFE Initiator & Responder Connections), mpServerHostname is the DA-MP on which the Connection became established. For Floating Connections that are not established, mpServerHostname is the DA-MP Leader, since it is the DA-MP Leader that reports status for un-established Floating Connections.",
"type": "string"
},
"name": {
"description": "Name for this Route List, which must be unique within the DSR site. A name is required, and cannot be changed after the Route List is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"operationalStatus": {
"description": "Route List can be, Available: the available capacity of the Route Group is greater than the Minimum Route Group Availability Weight.Degraded: the available capacity of the Route Group is greater than zero, but less than the Minimum Route Group Availability Weight.Unavailable: the Route Group available capacity is zero.Unknown: status information is not available in the database.",
"enum": [
"Available",
"Degraded",
"Unavailable",
"Unknown"
],
"type": "string"
},
"priority": {
"description": "The priority of this Route Group (/diameter/routegroups) within the Route List. A value of 1 indicates the highest priority Route Group, while a value of 3 indicates the lowest priority Route Group.",
"maximum": 3,
"minimum": 1,
"type": "integer"
},
"routeGroupName": {
"description": "Route Groups assigned to the Route List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this ETG are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this ETG. If the OAM has current status for this ETG, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "Time stamp that shows the last time the status information was updated.",
"pattern": "^[0-9]{4}[-][a-zA-Z]{3}[-][0-9]{2} [0-9]{2}[:][0-9]{2}[:][0-9]{2} .*$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"activeStandby": "Active",
"isDynamic": false,
"minCapacity": 100000,
"mpServerHostname": "MP1",
"name": "clientRouteList4",
"operationalStatus": "Available",
"priority": 1,
"routeGroupName": "clientRouteGroup1",
"statusKnown": true,
"timeOfLastUpdate": "2017-Aug-25 11:05:05 EDT"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Routing Option Sets
Each Routing Option Set is a collection of parameters that control how the DSR deals with a set of problems that can cause a request to fail to route to the egress Peer Node (/diameter/peernodes). A configured Routing Option Set can then be assigned to Peer Nodes and/or Transaction Configuration Sets (/diameter/transactionconfigurationsets).
For each Diameter message that enters the DSR for routing, a Routing Option Set is selected based on an algorithm. This algorithm works primarily with the configuration of the Peer Node that sent the message to the DSR. Each Peer Node configured at the SOAM can optionally have: 1) a Routing Option Set assigned to it, and/or 2) a Transaction Configuration Set assigned to it. The Transaction Configuration Set is a collection of rules that specify, for a given Application ID (/diameter/applicationids) and Command Code (/diameter/commandcodes) within an ingress message, which Routing Option Set, Pending Answer Timer (/diameter/pendinganswertimers), Application Route Table (/diameter/applicationroutetables), and Peer Route Table (/diameter/peerroutetables) are to be used to make the routing decision for that message.
If a Transaction Configuration Set is assigned to the Peer Node, and an ingress message matches a rule in the Transaction Configuration Set, then the Routing Option Set associated with the matching rule is selected. If no Transaction Configuration Set is assigned to the Peer Node, or if no rule in the assigned Transaction Configuration Set matches the ingress message, then the Routing Option Set assigned directly to the Peer Node is selected. Finally, if there is no Routing Option Set assigned to the Peer Node, the default Routing Option Set is selected.
All configuration of Routing Option Sets is done at the SOAM.
/diameter/routingoptionsets
get /diameter/routingoptionsets
Returns all configured Routing Option Sets.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/routingoptionsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routingoptionset/routingoptionset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) is congested. When Abandon is specified, the request message will simply be discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connCongestionErrMsg, connCongestionResultCode, and connCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) congestion occurs and connCongestionAction is set to SendAnswer. Not applicable if connCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) congestion occurs. Required if connCongestionAction is SendAnswer, not applicable if connCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connCongestionVendorId": {
"description": "If specified and connCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if connCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"connFailureAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) selection fails. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connFailureErrMsg, connFailureResultCode, and connFailureVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connFailureErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) failure occurs and connFailureAction is set to SendAnswer. Not applicable if connFailureAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connFailureResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) failure occurs. Required if connFailureAction is SendAnswer, not applicable if connFailureAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connFailureVendorId": {
"description": "If specified and connFailureAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connFailureVendorId is placed in the Vendor-Id AVP. Not applicable if connFailureAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"destRealmNotServedAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the destination realm is not served. This happens during implicit routing, when the DSR fails to find a realm/Application ID (/diameter/applicationids) match. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for destRealmNotServedErrMsg, destRealmNotServedResultCode, and destRealmNotServedVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"destRealmNotServedErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the destination realm is not served and destRealmNotServedAction is set to SendAnswer. Not applicable if destRealmNotServedAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"destRealmNotServedResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the destination realm is not served. Required if destRealmNotServedAction is SendAnswer, not applicable if destRealmNotServedAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"destRealmNotServedVendorId": {
"description": "If specified and destRealmNotServedAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for destRealmNotServedVendorId is placed in the Vendor-Id AVP. Not applicable if destRealmNotServeAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"maxPerMsgFwdAllowed": {
"description": "The number of times request routing is attempted. Typical value is 1.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Routing Option Set, which must be unique within the DSR site. A name is required, and cannot be changed after the Routing Option Set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedArtPrtErrorAction": {
"description": "Determines the action DSR takes when a nested Application Route Table or Peer Route Table search results in a loop or exceeds the maximum search depth of five tables. When Abandon is specified, the message is discarded. When SendAnswer is specified, an answer message is sent to the upstream ART or PRT, and that answer message has content based on the values specified for nestedArtPrtErrorErrMsg, nestedArtPrtErrorResultCode, and nestedArtPrtErrorVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"nestedArtPrtErrorErrMsg": {
"description": "Error message string placed in the Error-Message AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"nestedArtPrtErrorResultCode": {
"description": "Value placed in the Result-Code AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"nestedArtPrtErrorVendorId": {
"description": "If specified and nestedArtPrtErrorAction is set to SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for nestedArtPrtErrorVendorId is placed in the Vendor-Id AVP. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"noPeerResponseAction": {
"description": "Action the DSR takes when a received request message cannot be processed due to an answer timeout or transaction lifetime timeout (i.e., no Peer Node (/diameter/peernodes) response). When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for noPeerResponseErrMsg, noPeerResponseResultCode, and noPeerResponseVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"noPeerResponseErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when there is no Peer Node (/diameter/peernodes) response and noPeerResponseAction is set to SendAnswer. Not applicable if noPeerResponseAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"noPeerResponseResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when there is no Peer Node (/diameter/peernodes) response. Required if noPeerResponseAction is SendAnswer, not applicable if noPeerResponseAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"noPeerResponseVendorId": {
"description": "If specified and noPeerResponseAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for noPeerResponseVendorId is placed in the Vendor-Id AVP. Not applicable if noPeerResponseAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"peerRptCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the egress Peer Node (/diameter/peernodes) reports congestion. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for peerRptCongestionErrMsg, peerRptCongestionResultCode, and peerRptCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"peerRptCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion and peerRptCongestionAction is set to SendAnswer. Not applicable if peerRptCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"peerRptCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion. Required if peerRptCongestionAction is SendAnswer, not applicable if peerRptCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"peerRptCongestionVendorId": {
"description": "If specified and peerRptCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for peerRptCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if peerRptCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimer) associated with this Routing Option Set. If no Pending Answer Timer name is given, the egress Peer Node's (/diameter/peernodes) Pending Answer Timer is used (if it's defined) when processing transactions.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"resExhAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the MP server does not have sufficient free internal resources to process the request. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for resExhErrMsg, resExhResultCode, and resExhVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"resExhErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when resource exhaustion occurs and resExhAction is set to SendAnswer. Not applicable if resExhAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"resExhResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when resource exhaustion occurs. Required if resExhAction is SendAnswer, not applicable if resExhAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhVendorId": {
"description": "If specified and resExhAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for resExhVendorId is placed in the Vendor-Id AVP. Not applicable if resExhAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"transactionLifetime": {
"description": "The total time, in milliseconds, the DSR attempts to forward a request, including the initial and all subsequent routing attempts. Only required if maxPerMsgFwdAllowed is greater than 1. Typical value is 20000 ms.",
"maximum": 540000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"connCongestionAction",
"connFailureAction",
"destRealmNotServedAction",
"maxPerMsgFwdAllowed",
"name",
"noPeerResponseAction",
"peerRptCongestionAction",
"resExhAction"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "3986",
"connCongestionAction": "SendAnswer",
"connCongestionErrMsg": "The connection is in congestion.",
"connCongestionResultCode": 3002,
"connCongestionVendorId": 12345,
"connFailureAction": "SendAnswer",
"connFailureErrMsg": "The connection has failed.",
"connFailureResultCode": 3002,
"connFailureVendorId": 23456,
"destRealmNotServedAction": "SendAnswer",
"destRealmNotServedErrMsg": "The destination realm is not known to DSR.",
"destRealmNotServedResultCode": 3002,
"destRealmNotServedVendorId": 12345,
"maxPerMsgFwdAllowed": 1,
"name": "RoutingOptionSet1",
"nestedArtPrtErrorAction": "SendAnswer",
"nestedArtPrtErrorErrMsg": "Table not available.",
"nestedArtPrtErrorResultCode": 3002,
"nestedArtPrtErrorVendorId": 23456,
"noPeerResponseAction": "SendAnswer",
"noPeerResponseErrMsg": "The peer node is not responding.",
"noPeerResponseResultCode": 3002,
"noPeerResponseVendorId": 34567,
"peerRptCongestionAction": "SendAnswer",
"peerRptCongestionErrMsg": "The peer reports congestion.",
"peerRptCongestionResultCode": 3002,
"peerRptCongestionVendorId": 12345,
"pendingAnswerTimerName": "Default",
"resExhAction": "SendAnswer",
"resExhErrMsg": "Unable to process - internal resource exhaustion.",
"resExhResultCode": 5006,
"resExhVendorId": 23456,
"transactionLifetime": 1000
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/routingoptionsets
Adds a new Routing Option Set to the DSR configuration. The new Routing Option Set must have a name that is unique across all Routing Option Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routingoptionset/routingoptionset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) is congested. When Abandon is specified, the request message will simply be discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connCongestionErrMsg, connCongestionResultCode, and connCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) congestion occurs and connCongestionAction is set to SendAnswer. Not applicable if connCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) congestion occurs. Required if connCongestionAction is SendAnswer, not applicable if connCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connCongestionVendorId": {
"description": "If specified and connCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if connCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"connFailureAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) selection fails. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connFailureErrMsg, connFailureResultCode, and connFailureVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connFailureErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) failure occurs and connFailureAction is set to SendAnswer. Not applicable if connFailureAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connFailureResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) failure occurs. Required if connFailureAction is SendAnswer, not applicable if connFailureAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connFailureVendorId": {
"description": "If specified and connFailureAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connFailureVendorId is placed in the Vendor-Id AVP. Not applicable if connFailureAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"destRealmNotServedAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the destination realm is not served. This happens during implicit routing, when the DSR fails to find a realm/Application ID (/diameter/applicationids) match. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for destRealmNotServedErrMsg, destRealmNotServedResultCode, and destRealmNotServedVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"destRealmNotServedErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the destination realm is not served and destRealmNotServedAction is set to SendAnswer. Not applicable if destRealmNotServedAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"destRealmNotServedResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the destination realm is not served. Required if destRealmNotServedAction is SendAnswer, not applicable if destRealmNotServedAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"destRealmNotServedVendorId": {
"description": "If specified and destRealmNotServedAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for destRealmNotServedVendorId is placed in the Vendor-Id AVP. Not applicable if destRealmNotServeAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"maxPerMsgFwdAllowed": {
"description": "The number of times request routing is attempted. Typical value is 1.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Routing Option Set, which must be unique within the DSR site. A name is required, and cannot be changed after the Routing Option Set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedArtPrtErrorAction": {
"description": "Determines the action DSR takes when a nested Application Route Table or Peer Route Table search results in a loop or exceeds the maximum search depth of five tables. When Abandon is specified, the message is discarded. When SendAnswer is specified, an answer message is sent to the upstream ART or PRT, and that answer message has content based on the values specified for nestedArtPrtErrorErrMsg, nestedArtPrtErrorResultCode, and nestedArtPrtErrorVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"nestedArtPrtErrorErrMsg": {
"description": "Error message string placed in the Error-Message AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"nestedArtPrtErrorResultCode": {
"description": "Value placed in the Result-Code AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"nestedArtPrtErrorVendorId": {
"description": "If specified and nestedArtPrtErrorAction is set to SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for nestedArtPrtErrorVendorId is placed in the Vendor-Id AVP. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"noPeerResponseAction": {
"description": "Action the DSR takes when a received request message cannot be processed due to an answer timeout or transaction lifetime timeout (i.e., no Peer Node (/diameter/peernodes) response). When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for noPeerResponseErrMsg, noPeerResponseResultCode, and noPeerResponseVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"noPeerResponseErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when there is no Peer Node (/diameter/peernodes) response and noPeerResponseAction is set to SendAnswer. Not applicable if noPeerResponseAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"noPeerResponseResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when there is no Peer Node (/diameter/peernodes) response. Required if noPeerResponseAction is SendAnswer, not applicable if noPeerResponseAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"noPeerResponseVendorId": {
"description": "If specified and noPeerResponseAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for noPeerResponseVendorId is placed in the Vendor-Id AVP. Not applicable if noPeerResponseAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"peerRptCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the egress Peer Node (/diameter/peernodes) reports congestion. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for peerRptCongestionErrMsg, peerRptCongestionResultCode, and peerRptCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"peerRptCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion and peerRptCongestionAction is set to SendAnswer. Not applicable if peerRptCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"peerRptCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion. Required if peerRptCongestionAction is SendAnswer, not applicable if peerRptCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"peerRptCongestionVendorId": {
"description": "If specified and peerRptCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for peerRptCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if peerRptCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimer) associated with this Routing Option Set. If no Pending Answer Timer name is given, the egress Peer Node's (/diameter/peernodes) Pending Answer Timer is used (if it's defined) when processing transactions.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"resExhAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the MP server does not have sufficient free internal resources to process the request. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for resExhErrMsg, resExhResultCode, and resExhVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"resExhErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when resource exhaustion occurs and resExhAction is set to SendAnswer. Not applicable if resExhAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"resExhResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when resource exhaustion occurs. Required if resExhAction is SendAnswer, not applicable if resExhAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhVendorId": {
"description": "If specified and resExhAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for resExhVendorId is placed in the Vendor-Id AVP. Not applicable if resExhAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"transactionLifetime": {
"description": "The total time, in milliseconds, the DSR attempts to forward a request, including the initial and all subsequent routing attempts. Only required if maxPerMsgFwdAllowed is greater than 1. Typical value is 20000 ms.",
"maximum": 540000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"connCongestionAction",
"connFailureAction",
"destRealmNotServedAction",
"maxPerMsgFwdAllowed",
"name",
"noPeerResponseAction",
"peerRptCongestionAction",
"resExhAction"
],
"type": "object"
}
Example
{
"configurationLevel": "3986",
"connCongestionAction": "SendAnswer",
"connCongestionErrMsg": "The connection is in congestion.",
"connCongestionResultCode": 3002,
"connCongestionVendorId": 12345,
"connFailureAction": "SendAnswer",
"connFailureErrMsg": "The connection has failed.",
"connFailureResultCode": 3002,
"connFailureVendorId": 23456,
"destRealmNotServedAction": "SendAnswer",
"destRealmNotServedErrMsg": "The destination realm is not known to DSR.",
"destRealmNotServedResultCode": 3002,
"destRealmNotServedVendorId": 12345,
"maxPerMsgFwdAllowed": 1,
"name": "RoutingOptionSet1",
"nestedArtPrtErrorAction": "SendAnswer",
"nestedArtPrtErrorErrMsg": "Table not available.",
"nestedArtPrtErrorResultCode": 3002,
"nestedArtPrtErrorVendorId": 23456,
"noPeerResponseAction": "SendAnswer",
"noPeerResponseErrMsg": "The peer node is not responding.",
"noPeerResponseResultCode": 3002,
"noPeerResponseVendorId": 34567,
"peerRptCongestionAction": "SendAnswer",
"peerRptCongestionErrMsg": "The peer reports congestion.",
"peerRptCongestionResultCode": 3002,
"peerRptCongestionVendorId": 12345,
"pendingAnswerTimerName": "Default",
"resExhAction": "SendAnswer",
"resExhErrMsg": "Unable to process - internal resource exhaustion.",
"resExhResultCode": 5006,
"resExhVendorId": 23456,
"transactionLifetime": 1000
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/routingoptionsets/{name}
get /diameter/routingoptionsets/{name}
Returns the configuration details for the specified Routing Option Set. If the specified Routing Option Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/routingoptionsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routingoptionset/routingoptionset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) is congested. When Abandon is specified, the request message will simply be discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connCongestionErrMsg, connCongestionResultCode, and connCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) congestion occurs and connCongestionAction is set to SendAnswer. Not applicable if connCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) congestion occurs. Required if connCongestionAction is SendAnswer, not applicable if connCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connCongestionVendorId": {
"description": "If specified and connCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if connCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"connFailureAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) selection fails. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connFailureErrMsg, connFailureResultCode, and connFailureVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connFailureErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) failure occurs and connFailureAction is set to SendAnswer. Not applicable if connFailureAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connFailureResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) failure occurs. Required if connFailureAction is SendAnswer, not applicable if connFailureAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connFailureVendorId": {
"description": "If specified and connFailureAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connFailureVendorId is placed in the Vendor-Id AVP. Not applicable if connFailureAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"destRealmNotServedAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the destination realm is not served. This happens during implicit routing, when the DSR fails to find a realm/Application ID (/diameter/applicationids) match. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for destRealmNotServedErrMsg, destRealmNotServedResultCode, and destRealmNotServedVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"destRealmNotServedErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the destination realm is not served and destRealmNotServedAction is set to SendAnswer. Not applicable if destRealmNotServedAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"destRealmNotServedResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the destination realm is not served. Required if destRealmNotServedAction is SendAnswer, not applicable if destRealmNotServedAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"destRealmNotServedVendorId": {
"description": "If specified and destRealmNotServedAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for destRealmNotServedVendorId is placed in the Vendor-Id AVP. Not applicable if destRealmNotServeAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"maxPerMsgFwdAllowed": {
"description": "The number of times request routing is attempted. Typical value is 1.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Routing Option Set, which must be unique within the DSR site. A name is required, and cannot be changed after the Routing Option Set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedArtPrtErrorAction": {
"description": "Determines the action DSR takes when a nested Application Route Table or Peer Route Table search results in a loop or exceeds the maximum search depth of five tables. When Abandon is specified, the message is discarded. When SendAnswer is specified, an answer message is sent to the upstream ART or PRT, and that answer message has content based on the values specified for nestedArtPrtErrorErrMsg, nestedArtPrtErrorResultCode, and nestedArtPrtErrorVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"nestedArtPrtErrorErrMsg": {
"description": "Error message string placed in the Error-Message AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"nestedArtPrtErrorResultCode": {
"description": "Value placed in the Result-Code AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"nestedArtPrtErrorVendorId": {
"description": "If specified and nestedArtPrtErrorAction is set to SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for nestedArtPrtErrorVendorId is placed in the Vendor-Id AVP. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"noPeerResponseAction": {
"description": "Action the DSR takes when a received request message cannot be processed due to an answer timeout or transaction lifetime timeout (i.e., no Peer Node (/diameter/peernodes) response). When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for noPeerResponseErrMsg, noPeerResponseResultCode, and noPeerResponseVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"noPeerResponseErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when there is no Peer Node (/diameter/peernodes) response and noPeerResponseAction is set to SendAnswer. Not applicable if noPeerResponseAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"noPeerResponseResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when there is no Peer Node (/diameter/peernodes) response. Required if noPeerResponseAction is SendAnswer, not applicable if noPeerResponseAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"noPeerResponseVendorId": {
"description": "If specified and noPeerResponseAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for noPeerResponseVendorId is placed in the Vendor-Id AVP. Not applicable if noPeerResponseAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"peerRptCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the egress Peer Node (/diameter/peernodes) reports congestion. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for peerRptCongestionErrMsg, peerRptCongestionResultCode, and peerRptCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"peerRptCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion and peerRptCongestionAction is set to SendAnswer. Not applicable if peerRptCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"peerRptCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion. Required if peerRptCongestionAction is SendAnswer, not applicable if peerRptCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"peerRptCongestionVendorId": {
"description": "If specified and peerRptCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for peerRptCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if peerRptCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimer) associated with this Routing Option Set. If no Pending Answer Timer name is given, the egress Peer Node's (/diameter/peernodes) Pending Answer Timer is used (if it's defined) when processing transactions.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"resExhAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the MP server does not have sufficient free internal resources to process the request. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for resExhErrMsg, resExhResultCode, and resExhVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"resExhErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when resource exhaustion occurs and resExhAction is set to SendAnswer. Not applicable if resExhAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"resExhResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when resource exhaustion occurs. Required if resExhAction is SendAnswer, not applicable if resExhAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhVendorId": {
"description": "If specified and resExhAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for resExhVendorId is placed in the Vendor-Id AVP. Not applicable if resExhAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"transactionLifetime": {
"description": "The total time, in milliseconds, the DSR attempts to forward a request, including the initial and all subsequent routing attempts. Only required if maxPerMsgFwdAllowed is greater than 1. Typical value is 20000 ms.",
"maximum": 540000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"connCongestionAction",
"connFailureAction",
"destRealmNotServedAction",
"maxPerMsgFwdAllowed",
"name",
"noPeerResponseAction",
"peerRptCongestionAction",
"resExhAction"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "3986",
"connCongestionAction": "SendAnswer",
"connCongestionErrMsg": "The connection is in congestion.",
"connCongestionResultCode": 3002,
"connCongestionVendorId": 12345,
"connFailureAction": "SendAnswer",
"connFailureErrMsg": "The connection has failed.",
"connFailureResultCode": 3002,
"connFailureVendorId": 23456,
"destRealmNotServedAction": "SendAnswer",
"destRealmNotServedErrMsg": "The destination realm is not known to DSR.",
"destRealmNotServedResultCode": 3002,
"destRealmNotServedVendorId": 12345,
"maxPerMsgFwdAllowed": 1,
"name": "RoutingOptionSet1",
"nestedArtPrtErrorAction": "SendAnswer",
"nestedArtPrtErrorErrMsg": "Table not available.",
"nestedArtPrtErrorResultCode": 3002,
"nestedArtPrtErrorVendorId": 23456,
"noPeerResponseAction": "SendAnswer",
"noPeerResponseErrMsg": "The peer node is not responding.",
"noPeerResponseResultCode": 3002,
"noPeerResponseVendorId": 34567,
"peerRptCongestionAction": "SendAnswer",
"peerRptCongestionErrMsg": "The peer reports congestion.",
"peerRptCongestionResultCode": 3002,
"peerRptCongestionVendorId": 12345,
"pendingAnswerTimerName": "Default",
"resExhAction": "SendAnswer",
"resExhErrMsg": "Unable to process - internal resource exhaustion.",
"resExhResultCode": 5006,
"resExhVendorId": 23456,
"transactionLifetime": 1000
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/routingoptionsets/{name}
Updates the configuration for the specified Route Option Set. If the provided Routing Option Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/routingoptionset/routingoptionset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) is congested. When Abandon is specified, the request message will simply be discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connCongestionErrMsg, connCongestionResultCode, and connCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) congestion occurs and connCongestionAction is set to SendAnswer. Not applicable if connCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) congestion occurs. Required if connCongestionAction is SendAnswer, not applicable if connCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connCongestionVendorId": {
"description": "If specified and connCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if connCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"connFailureAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the last egress Connection (/diameter/connections) selection fails. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for connFailureErrMsg, connFailureResultCode, and connFailureVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"connFailureErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when Connection (/diameter/connections) failure occurs and connFailureAction is set to SendAnswer. Not applicable if connFailureAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"connFailureResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when Connection (/diameter/connections) failure occurs. Required if connFailureAction is SendAnswer, not applicable if connFailureAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"connFailureVendorId": {
"description": "If specified and connFailureAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for connFailureVendorId is placed in the Vendor-Id AVP. Not applicable if connFailureAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"destRealmNotServedAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the destination realm is not served. This happens during implicit routing, when the DSR fails to find a realm/Application ID (/diameter/applicationids) match. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node (/diameter/peernodes), and that answer message has content based on the values specified for destRealmNotServedErrMsg, destRealmNotServedResultCode, and destRealmNotServedVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"destRealmNotServedErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the destination realm is not served and destRealmNotServedAction is set to SendAnswer. Not applicable if destRealmNotServedAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"destRealmNotServedResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the destination realm is not served. Required if destRealmNotServedAction is SendAnswer, not applicable if destRealmNotServedAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"destRealmNotServedVendorId": {
"description": "If specified and destRealmNotServedAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for destRealmNotServedVendorId is placed in the Vendor-Id AVP. Not applicable if destRealmNotServeAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"maxPerMsgFwdAllowed": {
"description": "The number of times request routing is attempted. Typical value is 1.",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"name": {
"description": "Name for this Routing Option Set, which must be unique within the DSR site. A name is required, and cannot be changed after the Routing Option Set is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedArtPrtErrorAction": {
"description": "Determines the action DSR takes when a nested Application Route Table or Peer Route Table search results in a loop or exceeds the maximum search depth of five tables. When Abandon is specified, the message is discarded. When SendAnswer is specified, an answer message is sent to the upstream ART or PRT, and that answer message has content based on the values specified for nestedArtPrtErrorErrMsg, nestedArtPrtErrorResultCode, and nestedArtPrtErrorVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"nestedArtPrtErrorErrMsg": {
"description": "Error message string placed in the Error-Message AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"nestedArtPrtErrorResultCode": {
"description": "Value placed in the Result-Code AVP of the answer message when the maximum Application Route Table (/diameter/applicationroutetables) or Peer Route Table (/diamter/peerroutetables) search depth is exceeded, or when a nested ART/PRT search results in a loop of searched tables. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"nestedArtPrtErrorVendorId": {
"description": "If specified and nestedArtPrtErrorAction is set to SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for nestedArtPrtErrorVendorId is placed in the Vendor-Id AVP. Not applicable if nestedArtPrtErrorAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"noPeerResponseAction": {
"description": "Action the DSR takes when a received request message cannot be processed due to an answer timeout or transaction lifetime timeout (i.e., no Peer Node (/diameter/peernodes) response). When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for noPeerResponseErrMsg, noPeerResponseResultCode, and noPeerResponseVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"noPeerResponseErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when there is no Peer Node (/diameter/peernodes) response and noPeerResponseAction is set to SendAnswer. Not applicable if noPeerResponseAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"noPeerResponseResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when there is no Peer Node (/diameter/peernodes) response. Required if noPeerResponseAction is SendAnswer, not applicable if noPeerResponseAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"noPeerResponseVendorId": {
"description": "If specified and noPeerResponseAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for noPeerResponseVendorId is placed in the Vendor-Id AVP. Not applicable if noPeerResponseAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"peerRptCongestionAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the egress Peer Node (/diameter/peernodes) reports congestion. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for peerRptCongestionErrMsg, peerRptCongestionResultCode, and peerRptCongestionVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"peerRptCongestionErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion and peerRptCongestionAction is set to SendAnswer. Not applicable if peerRptCongestionAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"peerRptCongestionResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when the egress Peer Node (/diameter/peernodes) reports congestion. Required if peerRptCongestionAction is SendAnswer, not applicable if peerRptCongestionAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"peerRptCongestionVendorId": {
"description": "If specified and peerRptCongestionAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for peerRptCongestionVendorId is placed in the Vendor-Id AVP. Not applicable if peerRptCongestionAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"pendingAnswerTimerName": {
"description": "Name of the Pending Answer Timer (/diameter/pendinganswertimer) associated with this Routing Option Set. If no Pending Answer Timer name is given, the egress Peer Node's (/diameter/peernodes) Pending Answer Timer is used (if it's defined) when processing transactions.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"resExhAction": {
"description": "Action the DSR takes when a received request message cannot be processed because the MP server does not have sufficient free internal resources to process the request. When Abandon is specified, the request message is discarded. When SendAnswer is specified, an answer message is sent to the upstream Peer Node, and that answer message has content based on the values specified for resExhErrMsg, resExhResultCode, and resExhVendorId.",
"enum": [
"Abandon",
"SendAnswer"
],
"type": "string"
},
"resExhErrMsg": {
"description": "Error message string to be placed in the Error-Message AVP of the answer message when resource exhaustion occurs and resExhAction is set to SendAnswer. Not applicable if resExhAction is Abandon.",
"maxLength": 64,
"type": "string"
},
"resExhResultCode": {
"description": "Value to be placed in the Result-Code AVP of the answer message when resource exhaustion occurs. Required if resExhAction is SendAnswer, not applicable if resExhAction is Abandon.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhVendorId": {
"description": "If specified and resExhAction is SendAnswer, the answer message includes the Experimental-Result-Code grouped AVP, where the value specified for resExhVendorId is placed in the Vendor-Id AVP. Not applicable if resExhAction is Abandon.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"transactionLifetime": {
"description": "The total time, in milliseconds, the DSR attempts to forward a request, including the initial and all subsequent routing attempts. Only required if maxPerMsgFwdAllowed is greater than 1. Typical value is 20000 ms.",
"maximum": 540000,
"minimum": 100,
"type": "integer"
}
},
"required": [
"connCongestionAction",
"connFailureAction",
"destRealmNotServedAction",
"maxPerMsgFwdAllowed",
"name",
"noPeerResponseAction",
"peerRptCongestionAction",
"resExhAction"
],
"type": "object"
}
Example
{
"configurationLevel": "3986",
"connCongestionAction": "SendAnswer",
"connCongestionErrMsg": "The connection is in congestion.",
"connCongestionResultCode": 3002,
"connCongestionVendorId": 12345,
"connFailureAction": "SendAnswer",
"connFailureErrMsg": "The connection has failed.",
"connFailureResultCode": 3002,
"connFailureVendorId": 23456,
"destRealmNotServedAction": "SendAnswer",
"destRealmNotServedErrMsg": "The destination realm is not known to DSR.",
"destRealmNotServedResultCode": 3002,
"destRealmNotServedVendorId": 12345,
"maxPerMsgFwdAllowed": 1,
"name": "RoutingOptionSet1",
"nestedArtPrtErrorAction": "SendAnswer",
"nestedArtPrtErrorErrMsg": "Table not available.",
"nestedArtPrtErrorResultCode": 3002,
"nestedArtPrtErrorVendorId": 23456,
"noPeerResponseAction": "SendAnswer",
"noPeerResponseErrMsg": "The peer node is not responding.",
"noPeerResponseResultCode": 3002,
"noPeerResponseVendorId": 34567,
"peerRptCongestionAction": "SendAnswer",
"peerRptCongestionErrMsg": "The peer reports congestion.",
"peerRptCongestionResultCode": 3002,
"peerRptCongestionVendorId": 12345,
"pendingAnswerTimerName": "Default",
"resExhAction": "SendAnswer",
"resExhErrMsg": "Unable to process - internal resource exhaustion.",
"resExhResultCode": 5006,
"resExhVendorId": 23456,
"transactionLifetime": 1000
}
delete /diameter/routingoptionsets/{name}
Deletes the specified Routing Option Set from the SOAM configuration. A Routing Option Set can only be deleted if all delete validation checks pass. In general, if the Routing Option Set is part of the configuration of some other Managed Object, the Routing Option Set cannot be deleted. For example, if the Routing Option Set is named in a Route List (/diameter/routelists), the Routing Option Set must first be removed from the Route List. Then the Routing Option Set can be deleted from the configuration. An attempt to delete a Routing Option Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Shared Traffic Throttle Groups
A shared Traffic Throttle Group (TTG) is a collection of one to twenty Traffic Throttle Points (TTPs)(/diameter/trafficthrottlepoints), all of which share the same Application ID (/diameter/applicationids). A Shared Traffic Throttle Group can be associated with a Route Group as part of Route List (/diameter/routelists) configuration, and the same TTG can be associated with more than one Route List/Route Group, if desired.
The rate of egress messages having the specified Application ID can be throttled by the DSR, if congestion is occuring among the hosts that make up the TTG. More specifically, DSR periodically calculates a loss percentage for the TTG, based on the current state of the TTPs within the TTG. If the loss percentage for the TTG exceeds the maximum loss percentage threshold specified for the Route List/Route Group (part of the Route List configuration), DSR throttles egress request traffic to the Route Group associated with the TTG.
Any TTG configured at the local SOAM, and marked as shared is listed on the NOAM and available for assignment to a Route List, Route Group, TTG association at any SOAM in the diameter routing network.
/diameter/sharedtrafficthrottlegroups
/diameter/sharedtrafficthrottlegroups/{name}
Diameter: Signaling Firewall
The Signaling Firewall feature provides network security for Diameter networks in LTE domains. When you enable or disable a diameter or RADIUS connection, a notification is sent to the servers to update the firewall rules to allow or disallow incoming network traffic.
In new DSR installations, the Signaling Firewall is enabled by default; however, during a DSR upgrade without the feature, the Signaling Firewall is disabled by default. Otherwise, it uses the setting from the previous release.
All configuration of Signaling Firewall that intend to operate on DA-MP server is done by the System OAM only, following a set of firewall rules.
/diameter/signalingfirewalls/status
get /diameter/signalingfirewalls/status
Returns the status of all Signaling Firewalls that meet the criteria specified in the request.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/signalingfirewallstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/signalingfirewall/signalingfirewallstatus.json",
"properties": {
"adminState": {
"description": "The administrative state defines whether the Signaling Firewall is active and can be utilized. In new DSR installations, the Signaling Firewall is enabled by default; however, during a DSR upgrade without the feature, the Signaling Firewall is disabled by default. Otherwise, it uses the setting from the previous release.",
"enum": [
"Disabled",
"Enabled"
],
"default": "Enabled",
"type": "string"
},
"operationalReason": {
"description": "Operation reason describes the status. Degraded means firewall has failed on some but not all servers, Disabled means firewall is administratively disabled, Failed means error message, Operational means firewall is operational on all servers and Unknown means at least one server fails to report its firewall operational status.",
"type": "string"
},
"operationalStatus": {
"description": "Operational status from all active servers is collectively used to determine the status of the signaling firewall at a signaling node level. Operational means all servers operational. Degraded means one or more servers report failed, Disabled means one or more servers is administratively disabled, Failed means all servers failed, Operational means all servers operational and Unknown means one or more server fails to report.",
"enum": [
"Degraded",
"Disabled",
"Failed",
"Operational",
"Unknown"
],
"default": "Unknown",
"type": "string"
},
"servers": {
"description": "Set of active DA-MP servers reporting on the firewall status in the signaling node.",
"type": "array",
"items": {
"description": "DA-MP Server(s) information with their individual operational status and reason.",
"properties": {
"servers": {
"description": "DA-MP Server Name.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operational Status of the individual server.",
"type": "string"
},
"operationalStatus": {
"description": "Operational status forindividual active server.",
"enum": [
"Degraded",
"Disabled",
"Failed",
"Operational",
"Unknown"
],
"default": "Unknown",
"type": "string"
}
},
"type": "object"
},
"minItems": 0,
"maxItems": 64
},
"signalingNode": {
"description": "Name of the SOAM Server group.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"readOnly": true,
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Signaling Firewall are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this Signaling Firewall. If the OAM has current status for this Signaling Firewall, statusKnown is set to true.",
"type": "boolean"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"adminState": "Disabled",
"operationalReason": "Firewall is administratively Disabled",
"operationalStatus": "Disabled",
"servers": [{
"servers": "MP1",
"operationalReason": "Firewall is administratively Disabled on DA-MP",
"operationalStatus": "Disabled"
}],
"signalingNode": "SO_SG",
"statusKnown": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/signalingfirewalls/{signalingNode}/signalingfirewalladminstate
get /diameter/signalingfirewalls/{signalingNode}/signalingfirewalladminstate
Retrieves the administrative state for the specified Signaling Firewall, which can be Enabled or Disabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- signalingNode: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/signalingfirewalladminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/signalingfirewalladminstate/signalingfirewalladminstate.json",
"properties": {
"adminState": {
"description": "The administrative state defines whether the Signaling Firewall is active and can be utilized. In new DSR installations, the Signaling Firewall is enabled by default; however, during a DSR upgrade without the feature, the Signaling Firewall is disabled by default. Otherwise, it uses the setting from the previous release.",
"enum": [
"Enabled",
"Disabled"
],
"default": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/signalingfirewalls/{signalingNode}/signalingfirewalladminstate
Updates the administrative state for the specified Signaling Firewall to either Enabled or Disabled.
A Signaling Firewall can be enabled only if connection admin state is enabled, peer node identification value is not of IP address type and connection mode is not of an Initiator Only type.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- signalingNode: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/signalingfirewalladminstate/signalingfirewalladminstate.json",
"properties": {
"adminState": {
"description": "The administrative state defines whether the Signaling Firewall is active and can be utilized. In new DSR installations, the Signaling Firewall is enabled by default; however, during a DSR upgrade without the feature, the Signaling Firewall is disabled by default. Otherwise, it uses the setting from the previous release.",
"enum": [
"Enabled",
"Disabled"
],
"default": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
Diameter: Signaling IP Addresses
The Signaling IP Addresses resource provides all currently-configured signaling IP addresses for a Site, suitable for configuring Local Nodes (/diameter/localnodes) or IPFE Target Sets (/diameter/ipfetargetsets).
/diameter/signalingipaddresses
get /diameter/signalingipaddresses
Retrieves the set of valid signaling IP addresses for the Site. The returned collection includes both DA-MP signaling IP addresses and any Target Set Addresses (TSAs) configured at the SOAM.
Target server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/signalingipaddressCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/signalingipaddress/signalingipaddress.json",
"properties": {
"hostname": {
"description": "When ipType is LocalIp, this value is the name of the DA-MP with which the ipAddr is associated. When ipType is IpfeTsa, this value is the empty string.",
"type": "string"
},
"ipAddr": {
"description": "A single IP address, which can be IPv4 or IPv6.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipType": {
"description": "Each IP address is of type LocalIp or IpfeTsa. A Local IP is a fixed IP address assigned to a specific MP server within the DSR. An IPFE Target Set Address (TSA) is an IP address associated with a group of MP servers, which together are known as a Target Set.",
"enum": [
"LocalIp",
"IpfeTsa"
],
"type": "string"
},
"networkName": {
"description": "When ipType is LocalIp, this value is the name of the network of which ipAddr is a part. When ipType is IpfeTsa, this value is the empty string.",
"pattern": "^[A-Za-z][A-Za-z0-9]*$",
"maxLength": 31,
"type": "string"
},
"targetSetNumber": {
"description": "When ipType is IpfeTsa, this value is the number of the Target Set the ipAddr is associated with. When ipType is LocalIp, this value is zero.",
"maximum": 32,
"minimum": 0,
"type": "integer"
}
},
"readOnly": true,
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"hostname": "DAMP2",
"ipAddr": "75.40.31.13",
"ipType": LocalIp",
"networkName": "XSI1PV6",
"targetSetNumber": 0
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Traffic Throttle Groups
A Traffic Throttle Group (TTG) is a collection of one to twenty Traffic Throttle Points (TTPs)(/diameter/trafficthrottlepoints), all of which share the same Application ID (/diameter/applicationids). A Traffic Throttle Group can be associated with a Route Group as part of Route List (/diameter/routelists) configuration, and the same TTG can be associated with more than one Route List/Route Group, if desired.
The rate of egress messages having the specified Application ID can be throttled by the DSR, if congestion is occuring among the hosts that make up the TTG. More specifically, DSR periodically calculates a loss percentage for the TTG, based on the current state of the TTPs within the TTG. If the loss percentage for the TTG exceeds the maximum loss percentage threshold specified for the Route List/Route Group (part of the Route List configuration), DSR throttles egress request traffic to the Route Group associated with the TTG.
All configuration of Traffic Throttle Groups is done at the SOAM.
/diameter/trafficthrottlegroups
get /diameter/trafficthrottlegroups
Returns all Traffic Throttle Groups configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Traffic Throttle Groups meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/trafficthrottlegroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlegroup.json",
"properties": {
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Group.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for this Traffic Throttle Group, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"shared": {
"description": "When set to true, the Traffic Throttle Group is made visible to the other sites within the DSR network, and can therefore be selected for use by Route Lists (/diameter/routelists) configured at any other SOAM in the network. When set to false, the TTG is only visible to the SOAM at which the TTG is configured, and can only be selected for use by Route Lists configured at that same SOAM.",
"type": "boolean"
},
"trafficThrottlePointName": {
"description": "Array of 1 to 20 valid Traffic Throttle Point (/diameter/trafficthrottlepoints) names. All TTPs associated with a TTG must be configured at the same SOAM as the TTG, even if the TTG's shared value is true.",
"items": {
"description": "Name of a Traffic Throttle Point configured at the same SOAM as this TTG. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"appId",
"name",
"shared",
"trafficThrottlePointName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"appId": 4294967295,
"configurationLevel": "730978",
"name": "TTG1",
"shared": false,
"trafficThrottlePointName": [
"TTP1",
"TTP2",
"TTP3"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/trafficthrottlegroups
Adds a new Traffic Throttle Group to the DSR configuration. The new TTG must have a name that is unique across all TTGs at the SOAM. A TTG configured at one SOAM may duplicate the name of a TTG configured at a second SOAM, even if one or both are shared, since the SOAM name helps to uniquely identify a TTG when it is shared.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlegroup.json",
"properties": {
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Group.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for this Traffic Throttle Group, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"shared": {
"description": "When set to true, the Traffic Throttle Group is made visible to the other sites within the DSR network, and can therefore be selected for use by Route Lists (/diameter/routelists) configured at any other SOAM in the network. When set to false, the TTG is only visible to the SOAM at which the TTG is configured, and can only be selected for use by Route Lists configured at that same SOAM.",
"type": "boolean"
},
"trafficThrottlePointName": {
"description": "Array of 1 to 20 valid Traffic Throttle Point (/diameter/trafficthrottlepoints) names. All TTPs associated with a TTG must be configured at the same SOAM as the TTG, even if the TTG's shared value is true.",
"items": {
"description": "Name of a Traffic Throttle Point configured at the same SOAM as this TTG. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"appId",
"name",
"shared",
"trafficThrottlePointName"
],
"type": "object"
}
Example
{
"appId": 4294967295,
"configurationLevel": "730978",
"name": "TTG1",
"shared": false,
"trafficThrottlePointName": [
"TTP1",
"TTP2",
"TTP3"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/trafficthrottlegroups/trafficthrottlegroupadminstate
put /diameter/trafficthrottlegroups/trafficthrottlegroupadminstate
This PUT action updates the administrative state for all Traffic Throttle Groups.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trafficthrottlegroupadminstate/trafficthrottlegroupadminstate.json",
"properties": {
"adminState": {
"description": "A Traffic Throttle Group's administrative state can be either Enabled or Disabled. A Traffic Throttle Group's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
Response
HTTP status code 202
Successfully updated the administrative state of all Traffic Throttle Groups.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
HTTP status code 400
The administrative enable/disable failed.
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/items/emptyItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/bulk/empty/empty.json",
"properties": {
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
/diameter/trafficthrottlegroups/status
get /diameter/trafficthrottlegroups/status
Returns the status of all Traffic Throttle Groups that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings can be filtered using only EQUAL. The name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE, while the Time of Last Update can be filtered using only EQUAL or NOT_EQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
Returns the status of all Traffic Throttle Groups that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings can be filtered using only EQUAL. The name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE, while the Time of Last Update can be filtered using only EQUAL or NOT_EQUAL.
Example:
filter_name=adminState
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=Enabled
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/trafficthrottlegroupstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trafficthrottlegroup/trafficthrottlegroupstatus.json",
"properties": {
"adminState": {
"description": "The administrative state defines whether the Traffic Throttle Group is active and can be applied to routing. When adminState is set to Disabled, the TTG's currentLossPercent is ignored when making routing decisions.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"currentLossPercent": {
"description": "This is a weighted average of the current loss values for the Traffic Throttle Points (/diameter/trafficthrottlepoints) that make up the Traffic Throttle Group.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "The configured name of the Traffice Throttle Group.",
"type": "string"
},
"siteName": {
"description": "The name of the site to which this Traffic Throttle Group is owned and controlled.",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Traffic Throttle Group are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this TTG. If the OAM has current status for this TTG, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Traffic Throttle Group was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][a-zA-Z]{3}[-][0-9]{2} [0-9]{2}[:][0-9]{2}[:][0-9]{2} .*$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"adminState": "Enabled",
"currentLossPercent": 5,
"name": "trafficthrottlegroup1",
"siteName": "siteName1",
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/trafficthrottlegroups/{name}
get /diameter/trafficthrottlegroups/{name}
Returns the configuration details for the specified Traffic Throttle Group. If the specified TTG does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/trafficthrottlegroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlegroup.json",
"properties": {
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Group.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for this Traffic Throttle Group, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"shared": {
"description": "When set to true, the Traffic Throttle Group is made visible to the other sites within the DSR network, and can therefore be selected for use by Route Lists (/diameter/routelists) configured at any other SOAM in the network. When set to false, the TTG is only visible to the SOAM at which the TTG is configured, and can only be selected for use by Route Lists configured at that same SOAM.",
"type": "boolean"
},
"trafficThrottlePointName": {
"description": "Array of 1 to 20 valid Traffic Throttle Point (/diameter/trafficthrottlepoints) names. All TTPs associated with a TTG must be configured at the same SOAM as the TTG, even if the TTG's shared value is true.",
"items": {
"description": "Name of a Traffic Throttle Point configured at the same SOAM as this TTG. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"appId",
"name",
"shared",
"trafficThrottlePointName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"appId": 4294967295,
"configurationLevel": "730978",
"name": "TTG1",
"shared": false,
"trafficThrottlePointName": [
"TTP1",
"TTP2",
"TTP3"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/trafficthrottlegroups/{name}
Updates the configuration for the specified Traffic Throttle Group. If the provided TTG data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlegroup.json",
"properties": {
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Group.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for this Traffic Throttle Group, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Group is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"shared": {
"description": "When set to true, the Traffic Throttle Group is made visible to the other sites within the DSR network, and can therefore be selected for use by Route Lists (/diameter/routelists) configured at any other SOAM in the network. When set to false, the TTG is only visible to the SOAM at which the TTG is configured, and can only be selected for use by Route Lists configured at that same SOAM.",
"type": "boolean"
},
"trafficThrottlePointName": {
"description": "Array of 1 to 20 valid Traffic Throttle Point (/diameter/trafficthrottlepoints) names. All TTPs associated with a TTG must be configured at the same SOAM as the TTG, even if the TTG's shared value is true.",
"items": {
"description": "Name of a Traffic Throttle Point configured at the same SOAM as this TTG. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"appId",
"name",
"shared",
"trafficThrottlePointName"
],
"type": "object"
}
Example
{
"appId": 4294967295,
"configurationLevel": "730978",
"name": "TTG1",
"shared": false,
"trafficThrottlePointName": [
"TTP1",
"TTP2",
"TTP3"
]
}
delete /diameter/trafficthrottlegroups/{name}
Deletes the specified Traffic Throttle Group from the SOAM configuration. A TTG can only be deleted if all delete validation checks pass. In general, if the TTG is part of the configuration of some other Managed Object, the TTG cannot be deleted. For example, if the TTG is named in a Route List (/diameter/routelists), the TTG must first be removed from the Route List. Then the TTG can be deleted from the configuration. An attempt to delete a TTG that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/diameter/trafficthrottlegroups/{name}/trafficthrottlegroupadminstate
get /diameter/trafficthrottlegroups/{name}/trafficthrottlegroupadminstate
Retrieves the administrative state for the specified Traffic Throttle Group, which can be Enabled or Disabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/trafficthrottlegroupadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trafficthrottlegroupadminstate/trafficthrottlegroupadminstate.json",
"properties": {
"adminState": {
"description": "A Traffic Throttle Group's administrative state can be either Enabled or Disabled. A Traffic Throttle Group's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/trafficthrottlegroups/{name}/trafficthrottlegroupadminstate
Updates the administrative state for the specified Traffic Throttle Group to either Enabled or Disabled.
A Traffic Throttle Group's configuration cannot be modified or deleted if its administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trafficthrottlegroupadminstate/trafficthrottlegroupadminstate.json",
"properties": {
"adminState": {
"description": "A Traffic Throttle Group's administrative state can be either Enabled or Disabled. A Traffic Throttle Group's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
/diameter/trafficthrottlegroups/{name}/status
get /diameter/trafficthrottlegroups/{name}/status
Retrieves the operational status for the specified Traffic Throttle Group.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/trafficthrottlegroupstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trafficthrottlegroup/trafficthrottlegroupstatus.json",
"properties": {
"adminState": {
"description": "The administrative state defines whether the Traffic Throttle Group is active and can be applied to routing. When adminState is set to Disabled, the TTG's currentLossPercent is ignored when making routing decisions.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"currentLossPercent": {
"description": "This is a weighted average of the current loss values for the Traffic Throttle Points (/diameter/trafficthrottlepoints) that make up the Traffic Throttle Group.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "The configured name of the Traffice Throttle Group.",
"type": "string"
},
"siteName": {
"description": "The name of the site to which this Traffic Throttle Group is owned and controlled.",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Traffic Throttle Group are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this TTG. If the OAM has current status for this TTG, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Traffic Throttle Group was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][a-zA-Z]{3}[-][0-9]{2} [0-9]{2}[:][0-9]{2}[:][0-9]{2} .*$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled",
"currentLossPercent": 5,
"name": "trafficthrottlegroup1",
"siteName": "siteName1",
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Traffic Throttle Point Configuration Sets
Traffic Throttle Point (TTP) Configuration Sets provide a set of configuration attributes for a TTP (/diameter/trafficthrottlepoints) and can be assigned to one or more TTPs.
All TTP Configuration Set configuration is done at the SOAM.
/diameter/trafficthrottlepointconfigurationsets
get /diameter/trafficthrottlepointconfigurationsets
Returns all Traffic Throttle Point Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Traffic Throttle Point Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/trafficthrottlepointconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepointconfigurationset.json",
"properties": {
"abatementRecoveryRate": {
"description": "Once a DOIC overload condition expires, the traffic forwarded by the DSR to the Peer is ramped back up by abatementRecoveryRate percent per second. An example, assuming abatementRecoveryRate is set to 5%: during overload, if 20% of the request messages are being shed, then once the overload condition clears, DSR forwards 5% more traffic per second to the formerly-overloaded Peer Node (diameter/peernodes). Assuming there is no return to an overload condidtion, after four seconds, the DSR again forwards all traffic to the formerly-overloaded Peer Node with no throttling applied. Typical value is 5.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defaultReductionPercentage": {
"description": "When a Peer Node (diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating the Peer's desired traffic reduction (in percent). If the Peer Node does not specify the reduction percentage, DSR uses the value specified by default Reduction Percentage. Typical value is zero.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"defaultValidityDuration": {
"description": "When a Peer Node (/diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating for how long, in seconds, the Peer wants the traffic reduction. If the Peer Node does not specify the duration, DSR uses the value specified by default Validity Duration. Typical value is 30.",
"maximum": 86400,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Traffic Throttle Point Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Traffic Throttle Point Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"overrideMessagePriorityThreshold": {
"description": "If a value is supplied for this parameter, and the offered traffic rate to the TTP (/diameter/trafficthrottlepoints) is less than the TTP's maxEtr value, messages whose priority is greater than or equal to override Message Priority Threshold are immune from diversion. If, however, the offered traffic rate to the TTP is at or above the maxEtr value, then DSR can divert messages regardless of their priority.",
"enum": [1, 2],
"type": "integer"
},
"rateConvergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded to a TTP (/diameter/trafficthrottlepoints) per unit time - the offered rate. The time duration the DSR algorithm uses when calculating the offered rate, which is effectively a sample period - is specified by the rateConvergenceTime value, which is in milliseconds. If rateConvergenceTime is less than 1000 msec - meaning the sample time is less than one full second - the DSR extrapolates the per-second offered rate based on the observed egress request messages during the sample interval. If rateConvergenceTime is 1000 msec, then the offered rate is just the observed egress request messages during that 1000 msec interval. If rateConvergenceTime is 2000 msec, the offered rate is the average of the two one-second intervals. Typical value is 1000.",
"enum": [250, 500, 1000, 2000],
"type": "integer"
}
},
"required": [
"abatementRecoveryRate",
"defaultValidityDuration",
"name",
"rateConvergenceTime"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"abatementRecoveryRate": 5,
"configurationLevel": "47",
"defaultReductionPercentage": 0,
"defaultValidityDuration": 30,
"name": "TrafficThrottlePointConfigurationSet1",
"overrideMessagePriorityThreshold": 1,
"rateConvergenceTime": 1000
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/trafficthrottlepointconfigurationsets
Adds a new TTP Configuration Set to the DSR configuration. The new TTP Configuration Set must have a name that is unique across all TTP Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepointconfigurationset.json",
"properties": {
"abatementRecoveryRate": {
"description": "Once a DOIC overload condition expires, the traffic forwarded by the DSR to the Peer is ramped back up by abatementRecoveryRate percent per second. An example, assuming abatementRecoveryRate is set to 5%: during overload, if 20% of the request messages are being shed, then once the overload condition clears, DSR forwards 5% more traffic per second to the formerly-overloaded Peer Node (diameter/peernodes). Assuming there is no return to an overload condidtion, after four seconds, the DSR again forwards all traffic to the formerly-overloaded Peer Node with no throttling applied. Typical value is 5.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defaultReductionPercentage": {
"description": "When a Peer Node (diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating the Peer's desired traffic reduction (in percent). If the Peer Node does not specify the reduction percentage, DSR uses the value specified by default Reduction Percentage. Typical value is zero.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"defaultValidityDuration": {
"description": "When a Peer Node (/diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating for how long, in seconds, the Peer wants the traffic reduction. If the Peer Node does not specify the duration, DSR uses the value specified by default Validity Duration. Typical value is 30.",
"maximum": 86400,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Traffic Throttle Point Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Traffic Throttle Point Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"overrideMessagePriorityThreshold": {
"description": "If a value is supplied for this parameter, and the offered traffic rate to the TTP (/diameter/trafficthrottlepoints) is less than the TTP's maxEtr value, messages whose priority is greater than or equal to override Message Priority Threshold are immune from diversion. If, however, the offered traffic rate to the TTP is at or above the maxEtr value, then DSR can divert messages regardless of their priority.",
"enum": [1, 2],
"type": "integer"
},
"rateConvergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded to a TTP (/diameter/trafficthrottlepoints) per unit time - the offered rate. The time duration the DSR algorithm uses when calculating the offered rate, which is effectively a sample period - is specified by the rateConvergenceTime value, which is in milliseconds. If rateConvergenceTime is less than 1000 msec - meaning the sample time is less than one full second - the DSR extrapolates the per-second offered rate based on the observed egress request messages during the sample interval. If rateConvergenceTime is 1000 msec, then the offered rate is just the observed egress request messages during that 1000 msec interval. If rateConvergenceTime is 2000 msec, the offered rate is the average of the two one-second intervals. Typical value is 1000.",
"enum": [250, 500, 1000, 2000],
"type": "integer"
}
},
"required": [
"abatementRecoveryRate",
"defaultValidityDuration",
"name",
"rateConvergenceTime"
],
"type": "object"
}
Example
{
"abatementRecoveryRate": 5,
"configurationLevel": "47",
"defaultReductionPercentage": 0,
"defaultValidityDuration": 30,
"name": "TrafficThrottlePointConfigurationSet1",
"overrideMessagePriorityThreshold": 1,
"rateConvergenceTime": 1000
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/trafficthrottlepointconfigurationsets/{name}
get /diameter/trafficthrottlepointconfigurationsets/{name}
Returns the configuration details for the specified TTP Configuration Set. If the TTP Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/trafficthrottlepointconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepointconfigurationset.json",
"properties": {
"abatementRecoveryRate": {
"description": "Once a DOIC overload condition expires, the traffic forwarded by the DSR to the Peer is ramped back up by abatementRecoveryRate percent per second. An example, assuming abatementRecoveryRate is set to 5%: during overload, if 20% of the request messages are being shed, then once the overload condition clears, DSR forwards 5% more traffic per second to the formerly-overloaded Peer Node (diameter/peernodes). Assuming there is no return to an overload condidtion, after four seconds, the DSR again forwards all traffic to the formerly-overloaded Peer Node with no throttling applied. Typical value is 5.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defaultReductionPercentage": {
"description": "When a Peer Node (diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating the Peer's desired traffic reduction (in percent). If the Peer Node does not specify the reduction percentage, DSR uses the value specified by default Reduction Percentage. Typical value is zero.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"defaultValidityDuration": {
"description": "When a Peer Node (/diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating for how long, in seconds, the Peer wants the traffic reduction. If the Peer Node does not specify the duration, DSR uses the value specified by default Validity Duration. Typical value is 30.",
"maximum": 86400,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Traffic Throttle Point Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Traffic Throttle Point Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"overrideMessagePriorityThreshold": {
"description": "If a value is supplied for this parameter, and the offered traffic rate to the TTP (/diameter/trafficthrottlepoints) is less than the TTP's maxEtr value, messages whose priority is greater than or equal to override Message Priority Threshold are immune from diversion. If, however, the offered traffic rate to the TTP is at or above the maxEtr value, then DSR can divert messages regardless of their priority.",
"enum": [1, 2],
"type": "integer"
},
"rateConvergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded to a TTP (/diameter/trafficthrottlepoints) per unit time - the offered rate. The time duration the DSR algorithm uses when calculating the offered rate, which is effectively a sample period - is specified by the rateConvergenceTime value, which is in milliseconds. If rateConvergenceTime is less than 1000 msec - meaning the sample time is less than one full second - the DSR extrapolates the per-second offered rate based on the observed egress request messages during the sample interval. If rateConvergenceTime is 1000 msec, then the offered rate is just the observed egress request messages during that 1000 msec interval. If rateConvergenceTime is 2000 msec, the offered rate is the average of the two one-second intervals. Typical value is 1000.",
"enum": [250, 500, 1000, 2000],
"type": "integer"
}
},
"required": [
"abatementRecoveryRate",
"defaultValidityDuration",
"name",
"rateConvergenceTime"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"abatementRecoveryRate": 5,
"configurationLevel": "47",
"defaultReductionPercentage": 0,
"defaultValidityDuration": 30,
"name": "TrafficThrottlePointConfigurationSet1",
"overrideMessagePriorityThreshold": 1,
"rateConvergenceTime": 1000
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/trafficthrottlepointconfigurationsets/{name}
Updates the configuration of the specified TTP Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepointconfigurationset.json",
"properties": {
"abatementRecoveryRate": {
"description": "Once a DOIC overload condition expires, the traffic forwarded by the DSR to the Peer is ramped back up by abatementRecoveryRate percent per second. An example, assuming abatementRecoveryRate is set to 5%: during overload, if 20% of the request messages are being shed, then once the overload condition clears, DSR forwards 5% more traffic per second to the formerly-overloaded Peer Node (diameter/peernodes). Assuming there is no return to an overload condidtion, after four seconds, the DSR again forwards all traffic to the formerly-overloaded Peer Node with no throttling applied. Typical value is 5.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defaultReductionPercentage": {
"description": "When a Peer Node (diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating the Peer's desired traffic reduction (in percent). If the Peer Node does not specify the reduction percentage, DSR uses the value specified by default Reduction Percentage. Typical value is zero.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"defaultValidityDuration": {
"description": "When a Peer Node (/diameter/peernodes) reports overload to the DSR, it optionally includes a value indicating for how long, in seconds, the Peer wants the traffic reduction. If the Peer Node does not specify the duration, DSR uses the value specified by default Validity Duration. Typical value is 30.",
"maximum": 86400,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for the Traffic Throttle Point Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. This value is required for all Traffic Throttle Point Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"overrideMessagePriorityThreshold": {
"description": "If a value is supplied for this parameter, and the offered traffic rate to the TTP (/diameter/trafficthrottlepoints) is less than the TTP's maxEtr value, messages whose priority is greater than or equal to override Message Priority Threshold are immune from diversion. If, however, the offered traffic rate to the TTP is at or above the maxEtr value, then DSR can divert messages regardless of their priority.",
"enum": [1, 2],
"type": "integer"
},
"rateConvergenceTime": {
"description": "The DSR uses an algorithm to determine how many request messages are being forwarded to a TTP (/diameter/trafficthrottlepoints) per unit time - the offered rate. The time duration the DSR algorithm uses when calculating the offered rate, which is effectively a sample period - is specified by the rateConvergenceTime value, which is in milliseconds. If rateConvergenceTime is less than 1000 msec - meaning the sample time is less than one full second - the DSR extrapolates the per-second offered rate based on the observed egress request messages during the sample interval. If rateConvergenceTime is 1000 msec, then the offered rate is just the observed egress request messages during that 1000 msec interval. If rateConvergenceTime is 2000 msec, the offered rate is the average of the two one-second intervals. Typical value is 1000.",
"enum": [250, 500, 1000, 2000],
"type": "integer"
}
},
"required": [
"abatementRecoveryRate",
"defaultValidityDuration",
"name",
"rateConvergenceTime"
],
"type": "object"
}
Example
{
"abatementRecoveryRate": 5,
"configurationLevel": "47",
"defaultReductionPercentage": 0,
"defaultValidityDuration": 30,
"name": "TrafficThrottlePointConfigurationSet1",
"overrideMessagePriorityThreshold": 1,
"rateConvergenceTime": 1000
}
delete /diameter/trafficthrottlepointconfigurationsets/{name}
Deletes the specified TTP Configuration Set from the SOAM configuration. The Default TTP Configuration Set cannot be deleted. A TTP Configuration Set can only be deleted if all delete validation checks pass. In general, if the TTP Configuration Set is part of the configuration of some other Managed Object, the TTP Configuration Set cannot be deleted. For example, if the TTP Configuration Set is named by a TTP, the TTP Configuration Set must be removed from the TTP. Then the TTP Configuration Set can be deleted from the configuration. An attempt to delete a TTP Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Traffic Throttle Points
A Traffic Throttle Point (TTP) is a logical entity corresponding to a specific Peer Node (/diameter/peernodes) and Diameter Application ID (/diameter/applicationids). When the DSR selects a Peer Node or Connection (/diameter/connections) from a Route Group (/diameter/routegroups), or selects a Peer Node for implicit routing, DSR checks if a TTP has been configured for the selected Peer Node and the Application ID specified in the request message. If a TTP exists and is administratively enabled, transmission of the request message may be subject to throttling, if the conditions prescribed by the TTP and its assigned TTP Configuration Set (/diameter/trafficthrottlepointconfigurationsets) are met.
All configuration of Traffic Throttle Points is done at the SOAM.
/diameter/trafficthrottlepoints
get /diameter/trafficthrottlepoints
Returns all Traffic Throttle Points configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Traffic Throttle Points meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/trafficthrottlepointCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepoint.json",
"properties": {
"altImplicitRouteListName": {
"description": "Name of the Route List (/diameter/routelists) used for routing messages when the primary route to the Peer Node (/diameter/peernodes) is unavailable and implicit routing is invoked.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Point.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxEtr": {
"description": "The maximum allowed Egress Transaction Rate (ETR) for this TTP. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"maxLossPercentThresh": {
"description": "When the current percent loss (as reported by the Peer Node (/diameter/peernodes)) is at or above maxLossPercentThresh, the DSR stops forwarding requests to the Peer Node associated with this TTP. Typical value is 100.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this Traffic Throttle Point, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Point is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttpConfigurationSetName": {
"description": "Name of the TTP Configuration Set (/diameter/trafficthrottlepointconfigurationsets) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId",
"maxEtr",
"maxLossPercentThresh",
"name",
"peerNodeName",
"ttpConfigurationSetName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"altImplicitRouteListName": "RL4",
"appId": 4294967295,
"configurationLevel": "5200",
"maxEtr": 6000,
"maxLossPercentThresh": 100,
"name": "TTP1",
"peerNodeName": "PN123",
"ttpConfigurationSetName": "ttpCfgSet1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/trafficthrottlepoints
Adds a new Traffic Throttle Point to the DSR configuration. The new TTP must have a name that is unique across all TTPs at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepoint.json",
"properties": {
"altImplicitRouteListName": {
"description": "Name of the Route List (/diameter/routelists) used for routing messages when the primary route to the Peer Node (/diameter/peernodes) is unavailable and implicit routing is invoked.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Point.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxEtr": {
"description": "The maximum allowed Egress Transaction Rate (ETR) for this TTP. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"maxLossPercentThresh": {
"description": "When the current percent loss (as reported by the Peer Node (/diameter/peernodes)) is at or above maxLossPercentThresh, the DSR stops forwarding requests to the Peer Node associated with this TTP. Typical value is 100.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this Traffic Throttle Point, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Point is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttpConfigurationSetName": {
"description": "Name of the TTP Configuration Set (/diameter/trafficthrottlepointconfigurationsets) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId",
"maxEtr",
"maxLossPercentThresh",
"name",
"peerNodeName",
"ttpConfigurationSetName"
],
"type": "object"
}
Example
{
"altImplicitRouteListName": "RL4",
"appId": 4294967295,
"configurationLevel": "5200",
"maxEtr": 6000,
"maxLossPercentThresh": 100,
"name": "TTP1",
"peerNodeName": "PN123",
"ttpConfigurationSetName": "ttpCfgSet1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/trafficthrottlepoints/status
get /diameter/trafficthrottlepoints/status
Returns the status of all Traffic Throttle Points that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data. Integer attributes can be filtered using EQUAL and NOT_EQUAL. Boolean attributes and enumerated strings (except for Operation Reason) can be filtered using only EQUAL. The Operation Reason attribute can be filtered using EQUAL or NOT_EQUAL. The name attribute can be filtered using EQUAL, NOT_EQUAL, or LIKE.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=dynamicThrottlingAdminState
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on.
Example:
filter_values=Enabled
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/trafficthrottlepointstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trafficthrottlepoint/trafficthrottlepointstatus.json",
"properties": {
"abatementAlgorithm": {
"description": "Abatement algorithm applied as a result of receiving an Overload Report associated with the Traffic Throttle Point (TTP's Operational Reason = Peer Overload). The abatementAlgorithm is None unless an Overload Report is active, in which case the value is Loss.",
"enum": [
"None",
"Loss"
],
"type": "string"
},
"currentLossPercent": {
"description": "The reduction percentage currently being applied to the traffic routed to this Traffic Throttle Point based upon an Overload Report received from this TTP's egress Peer Node (/diameter/peernodes).",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"dynamicThrottlingAdminState": {
"description": "The dynamicThrottlingAdminState controls DOIC interactions with the egress Peer Node (/diameter/peernodes) configured for the Traffic Throttle Point. If the dynamicThrottlingAdminState is set to Enabled, the DSR appends DCA (DOIC Capability Announcement) AVPs to requests going to the TTP's egress Peer Node, and processes DOIC OLR (Overload Report) AVPs in answer messages coming back from the TTP's egress Peer Node.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"egressTransactionsPerSecond": {
"description": "The target number of egress transactions allowed per second based on current static and dynamic overload conditions.",
"type": "integer"
},
"maximumTransactionsPerSecond": {
"description": "The maximum number of egress transactions allowed per second. This value can vary based on dynamic throttling.",
"type": "integer"
},
"name": {
"description": "The configured name of the Traffice Throttle Point.",
"type": "string"
},
"offeredTransactionsPerSecond": {
"description": "The number of transactions per second routed to the Traffic Throttle Point before any diversion is applied.",
"type": "integer"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Traffic Throttle Point.",
"type": "string"
},
"operationalStatus": {
"description": "The operational status for this Traffic Throttle Point. The operationalReason value contains additional information elaborating on the reported operationalStatus.",
"enum": [
"Available",
"Degraded",
"Inactive"
],
"type": "string"
},
"percentOfTransactionsDiverted": {
"description": "The percentage of transactions routed to the Traffic Throttle Point that are diverted or abandoned.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"staticThrottlingAdminState": {
"description": "When staticThrottlingAdminState is set to Enabled, requests are throttled when the egress traffic rate exceeds the maximum egress throttle rate configured against the Traffic Throttle Point. When the staticThrottlingAdminState is disabled, the dynamicThrottlingAdminState cannot be changed or disabled. The staticThrottlingAdminState must first be set to Enabled before the dynamicThrottlingAdminState can be Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Traffic Throttle Point are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this TTP. If the OAM has current status for this TTP, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Traffic Throttle Point was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"timeAtWhichLossEqualsZeroPercent": {
"description": "The date/time when an active dynamic overload state and abatement are due to expire.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"validityDuration": {
"description": "The duration (in seconds) that the loss percentage from an Overload Report should be applied.",
"maximum": 86400,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"abatementAlgorithm": "Loss",
"currentLossPercent": 5,
"dynamicThrottlingAdminState": "Enabled",
"egressTransactionsPerSecond": 285,
"maximumTransactionsPerSecond": 500,
"name": "trafficthrottlepointstatus1",
"offeredTransactionsPerSecond": 300,
"operationalReason": "Normal",
"operationalStatus": "Available",
"percentOfTransactionsDiverted": 5,
"staticThrottlingAdminState": "Enabled",
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT",
"timeAtWhichLossEqualsZeroPercent": "2016-Aug-25 12:47:50 EDT",
"validityDuration": 30
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/diameter/trafficthrottlepoints/{name}
get /diameter/trafficthrottlepoints/{name}
Returns the configuration details for the specified Traffic Throttle Point. If the specified TTP does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/trafficthrottlepointItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepoint.json",
"properties": {
"altImplicitRouteListName": {
"description": "Name of the Route List (/diameter/routelists) used for routing messages when the primary route to the Peer Node (/diameter/peernodes) is unavailable and implicit routing is invoked.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Point.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxEtr": {
"description": "The maximum allowed Egress Transaction Rate (ETR) for this TTP. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"maxLossPercentThresh": {
"description": "When the current percent loss (as reported by the Peer Node (/diameter/peernodes)) is at or above maxLossPercentThresh, the DSR stops forwarding requests to the Peer Node associated with this TTP. Typical value is 100.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this Traffic Throttle Point, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Point is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttpConfigurationSetName": {
"description": "Name of the TTP Configuration Set (/diameter/trafficthrottlepointconfigurationsets) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId",
"maxEtr",
"maxLossPercentThresh",
"name",
"peerNodeName",
"ttpConfigurationSetName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"altImplicitRouteListName": "RL4",
"appId": 4294967295,
"configurationLevel": "5200",
"maxEtr": 6000,
"maxLossPercentThresh": 100,
"name": "TTP1",
"peerNodeName": "PN123",
"ttpConfigurationSetName": "ttpCfgSet1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/trafficthrottlepoints/{name}
Updates the configuration for the specified Traffic Throttle Point. If the provided TTP data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/trafficthrottlepoint.json",
"properties": {
"altImplicitRouteListName": {
"description": "Name of the Route List (/diameter/routelists) used for routing messages when the primary route to the Peer Node (/diameter/peernodes) is unavailable and implicit routing is invoked.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"appId": {
"description": "The Diameter Application ID (/diameter/applicationids) associated with this Traffic Throttle Point.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"maxEtr": {
"description": "The maximum allowed Egress Transaction Rate (ETR) for this TTP. Typical value is 6000.",
"maximum": 250000,
"minimum": 100,
"type": "integer"
},
"maxLossPercentThresh": {
"description": "When the current percent loss (as reported by the Peer Node (/diameter/peernodes)) is at or above maxLossPercentThresh, the DSR stops forwarding requests to the Peer Node associated with this TTP. Typical value is 100.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this Traffic Throttle Point, which must be unique within the DSR site. A name is required, and cannot be changed after the Traffic Throttle Point is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxlength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"peerNodeName": {
"description": "Name of the Peer Node (/diameter/peernodes) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ttpConfigurationSetName": {
"description": "Name of the TTP Configuration Set (/diameter/trafficthrottlepointconfigurationsets) associated with this TTP.",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId",
"maxEtr",
"maxLossPercentThresh",
"name",
"peerNodeName",
"ttpConfigurationSetName"
],
"type": "object"
}
Example
{
"altImplicitRouteListName": "RL4",
"appId": 4294967295,
"configurationLevel": "5200",
"maxEtr": 6000,
"maxLossPercentThresh": 100,
"name": "TTP1",
"peerNodeName": "PN123",
"ttpConfigurationSetName": "ttpCfgSet1"
}
delete /diameter/trafficthrottlepoints/{name}
Deletes the specified Traffic Throttle Point from the SOAM configuration. A TTP can only be deleted if all delete validation checks pass. In general, if the TTP is part of the configuration of some other Managed Object, the TTP cannot be deleted. For example, if the TTP is named in a Traffic Throttle Group (/diameter/trafficthrottlegroups), the TTP must first be removed from the TTG. Then the TTP can be deleted from the configuration. An attempt to delete a TTP that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/diameter/trafficthrottlepoints/{name}/staticthrottlingadminstate
get /diameter/trafficthrottlepoints/{name}/staticthrottlingadminstate
Retrieves the static throttling administrative state for the specified Traffic Throttle Point, which can be Enabled or Disabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/staticthrottlingadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/staticthrottlingadminstate/staticthrottlingadminstate.json",
"properties": {
"adminState": {
"description": "A Traffic Throttle Point's static throttling administrative state can be either Enabled or Disabled. Static throttling can be enabled to limit the rate of transactions that are forwarded to a particular Peer Node (/diameter/peernodes) which are addressed to a particular Diameter Application ID (/diameter/applicationid). A Traffic Throttle Point's configuration cannot be modified or deleted if its static throttling administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/trafficthrottlepoints/{name}/staticthrottlingadminstate
Updates the static throttling administrative state for the specified Traffic Throttle Point to either Enabled or Disabled.
A Traffic Throttle Point's configuration cannot be modified or deleted if its static throttling administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/staticthrottlingadminstate/staticthrottlingadminstate.json",
"properties": {
"adminState": {
"description": "A Traffic Throttle Point's static throttling administrative state can be either Enabled or Disabled. Static throttling can be enabled to limit the rate of transactions that are forwarded to a particular Peer Node (/diameter/peernodes) which are addressed to a particular Diameter Application ID (/diameter/applicationid). A Traffic Throttle Point's configuration cannot be modified or deleted if its static throttling administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
/diameter/trafficthrottlepoints/{name}/dynamicthrottlingadminstate
get /diameter/trafficthrottlepoints/{name}/dynamicthrottlingadminstate
Retrieves the dynamic throttling administrative state for the specified Traffic Throttle Point, which can be Enabled or Disabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/dynamicthrottlingadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dynamicthrottlingadminstate/dynamicthrottlingadminstate.json",
"properties": {
"adminState": {
"description": "A Traffic Throttle Point's dynamic throttling administrative state can be either Enabled or Disabled. Dynamic throttling can be enabled to perform Diameter Overload Indication Conveyance(DOIC) throttling. Static Throttling administrative state must be enabled before dynamic throttling administrative state can be enabled. A Traffic Throttle Point's configuration cannot be modified or deleted if its static throttling administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/trafficthrottlepoints/{name}/dynamicthrottlingadminstate
Updates the dynamic throttling administrative state for the specified Traffic Throttle Point to either Enable or Disabled. The dynamic throttling administrative state of a Traffic Throttle Point cannot be enabled unless the static throttling administrative state is also enabled.
A Traffic Throttle Point's configuration cannot be modified or deleted if its dynamic throttling administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/dynamicthrottlingadminstate/dynamicthrottlingadminstate.json",
"properties": {
"adminState": {
"description": "A Traffic Throttle Point's dynamic throttling administrative state can be either Enabled or Disabled. Dynamic throttling can be enabled to perform Diameter Overload Indication Conveyance(DOIC) throttling. Static Throttling administrative state must be enabled before dynamic throttling administrative state can be enabled. A Traffic Throttle Point's configuration cannot be modified or deleted if its static throttling administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": [
"adminState"
],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
/diameter/trafficthrottlepoints/{name}/status
get /diameter/trafficthrottlepoints/{name}/status
Retrieves the operational status for the specified Traffic Throttle Point.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/trafficthrottlepointstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trafficthrottlepoint/trafficthrottlepointstatus.json",
"properties": {
"abatementAlgorithm": {
"description": "Abatement algorithm applied as a result of receiving an Overload Report associated with the Traffic Throttle Point (TTP's Operational Reason = Peer Overload). The abatementAlgorithm is None unless an Overload Report is active, in which case the value is Loss.",
"enum": [
"None",
"Loss"
],
"type": "string"
},
"currentLossPercent": {
"description": "The reduction percentage currently being applied to the traffic routed to this Traffic Throttle Point based upon an Overload Report received from this TTP's egress Peer Node (/diameter/peernodes).",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"dynamicThrottlingAdminState": {
"description": "The dynamicThrottlingAdminState controls DOIC interactions with the egress Peer Node (/diameter/peernodes) configured for the Traffic Throttle Point. If the dynamicThrottlingAdminState is set to Enabled, the DSR appends DCA (DOIC Capability Announcement) AVPs to requests going to the TTP's egress Peer Node, and processes DOIC OLR (Overload Report) AVPs in answer messages coming back from the TTP's egress Peer Node.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"egressTransactionsPerSecond": {
"description": "The target number of egress transactions allowed per second based on current static and dynamic overload conditions.",
"type": "integer"
},
"maximumTransactionsPerSecond": {
"description": "The maximum number of egress transactions allowed per second. This value can vary based on dynamic throttling.",
"type": "integer"
},
"name": {
"description": "The configured name of the Traffice Throttle Point.",
"type": "string"
},
"offeredTransactionsPerSecond": {
"description": "The number of transactions per second routed to the Traffic Throttle Point before any diversion is applied.",
"type": "integer"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Traffic Throttle Point.",
"type": "string"
},
"operationalStatus": {
"description": "The operational status for this Traffic Throttle Point. The operationalReason value contains additional information elaborating on the reported operationalStatus.",
"enum": [
"Available",
"Degraded",
"Inactive"
],
"type": "string"
},
"percentOfTransactionsDiverted": {
"description": "The percentage of transactions routed to the Traffic Throttle Point that are diverted or abandoned.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"staticThrottlingAdminState": {
"description": "When staticThrottlingAdminState is set to Enabled, requests are throttled when the egress traffic rate exceeds the maximum egress throttle rate configured against the Traffic Throttle Point. When the staticThrottlingAdminState is disabled, the dynamicThrottlingAdminState cannot be changed or disabled. The staticThrottlingAdminState must first be set to Enabled before the dynamicThrottlingAdminState can be Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Traffic Throttle Point are not known by the OAM. This could be due to merge issues within the DSR, or some other cause preventing the OAM from having a current view of the status of this TTP. If the OAM has current status for this TTP, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Traffic Throttle Point was last updated by the DSR.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"timeAtWhichLossEqualsZeroPercent": {
"description": "The date/time when an active dynamic overload state and abatement are due to expire.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"validityDuration": {
"description": "The duration (in seconds) that the loss percentage from an Overload Report should be applied.",
"maximum": 86400,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"abatementAlgorithm": "Loss",
"currentLossPercent": 5,
"dynamicThrottlingAdminState": "Enabled",
"egressTransactionsPerSecond": 285,
"maximumTransactionsPerSecond": 500,
"name": "trafficthrottlepointstatus1",
"offeredTransactionsPerSecond": 300,
"operationalReason": "Normal",
"operationalStatus": "Available",
"percentOfTransactionsDiverted": 5,
"staticThrottlingAdminState": "Enabled",
"statusKnown": true,
"timeOfLastUpdate": "2016-Aug-25 11:05:05 EDT",
"timeAtWhichLossEqualsZeroPercent": "2016-Aug-25 12:47:50 EDT",
"validityDuration": 30
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Diameter: Transaction Configuration Sets
A Transaction Configuration Set provides a way to assign routing and transaction attributes, i.e., the Routing Option Set (/diameter/routingoptionsets), Pending Answer Timer (/diameter/pendinganswertimers), Application Route Table (/diameter/applicationroutetables), and Peer Route Table (/diameter/peerroutetables), to an ingress Diameter request message based on the Application Id (/diameter/applicationids) and Command Code (/diameter/commandcodes). A Transaction Configuration Set can be configured to contain one or more Transaction Configuration Rules.
The Transaction Configuration Set named Default is always available. The Default Transaction Configuration Set can be modified, but it cannot be deleted.
All Transaction Configuration Set configuration is done at the SOAM.
/diameter/transactionconfigurationsets
get /diameter/transactionconfigurationsets
Returns all Transaction Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Transaction Configuration Sets meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/transactionconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/transactionconfigurationset/transactionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Transaction Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"transactionRule": {
"description": "The rules associated with this Transaction Configuration Set. Each rule is defined by the appId and, optionally, cmdCode both of which are found in the Diameter request message header. Each rule must have at least one applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, or routingOptionSetName defined.",
"items": {
"properties": {
"appId": {
"description": "The appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Transaction Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId value in this rule (and also matches the cmdCode, if this rule contains a cmdCode value), according to the applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, and routingOptionSetName values (whichever of the four are specified) configured in the rule. The value must be an integer in the range 0-4294967295.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"applicationRouteTableName": {
"description": "If provided, specifies the Application Route Table (/diameter/applicationroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cmdCode": {
"description": "If specified, identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match.",
"maxLength": 30,
"type": "string"
},
"peerRouteTableName": {
"description": "If provided, specifies the Peer Route Table (/diameter/peerroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "If provided, specifies the Pending Answer Timer (/diameter/pendinganswertimers) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingOptionSetName": {
"description": "If provided, specifies the Routing Option Set (/diameter/routingoptionsets) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"maxItems": 1000,
"minItems": 0,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "0",
"name": "TransactionConfigurationSet1",
"transactionConfigurationRule": {
"items": [{
"appId": 16777216,
"applicationRouteTableName": "OcdraART",
"cmdCode": "258",
"peerRouteTableName": "NGNPS",
"pendingAnswerTimerName": "sw_PAT_1",
"routingOptionSetName": "sw_ROS_1"
}, {
"appId": 3,
"applicationRouteTableName": "PdraART",
"cmdCode": "300.623.0",
"peerRouteTableName": "Radius",
"routingOptionSetName": "sw_ROS_2"
}, {
"appId": 4294967295,
"cmdCode": "265.274.1",
"pendingAnswerTimerName": "sw_PAT_3",
"routingOptionSetName": "sw_ROS_3"
}]
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/transactionconfigurationsets
Adds a new Transaction Configuration Set to the DSR configuration. The Transaction Configuration Set must have a name that is unique across all Transaction Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/transactionconfigurationset/transactionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Transaction Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"transactionRule": {
"description": "The rules associated with this Transaction Configuration Set. Each rule is defined by the appId and, optionally, cmdCode both of which are found in the Diameter request message header. Each rule must have at least one applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, or routingOptionSetName defined.",
"items": {
"properties": {
"appId": {
"description": "The appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Transaction Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId value in this rule (and also matches the cmdCode, if this rule contains a cmdCode value), according to the applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, and routingOptionSetName values (whichever of the four are specified) configured in the rule. The value must be an integer in the range 0-4294967295.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"applicationRouteTableName": {
"description": "If provided, specifies the Application Route Table (/diameter/applicationroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cmdCode": {
"description": "If specified, identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match.",
"maxLength": 30,
"type": "string"
},
"peerRouteTableName": {
"description": "If provided, specifies the Peer Route Table (/diameter/peerroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "If provided, specifies the Pending Answer Timer (/diameter/pendinganswertimers) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingOptionSetName": {
"description": "If provided, specifies the Routing Option Set (/diameter/routingoptionsets) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"maxItems": 1000,
"minItems": 0,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"name": "TransactionConfigurationSet1",
"transactionConfigurationRule": {
"items": [{
"appId": 16777216,
"applicationRouteTableName": "OcdraART",
"cmdCode": "258",
"peerRouteTableName": "NGNPS",
"pendingAnswerTimerName": "sw_PAT_1",
"routingOptionSetName": "sw_ROS_1"
}, {
"appId": 3,
"applicationRouteTableName": "PdraART",
"cmdCode": "300.623.0",
"peerRouteTableName": "Radius",
"routingOptionSetName": "sw_ROS_2"
}, {
"appId": 4294967295,
"cmdCode": "265.274.1",
"pendingAnswerTimerName": "sw_PAT_3",
"routingOptionSetName": "sw_ROS_3"
}]
}
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/transactionconfigurationsets/{name}
get /diameter/transactionconfigurationsets/{name}
Returns the configuration details for the specified Transaction Configuration Set. If the Transaction Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/transactionconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/transactionconfigurationset/transactionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Transaction Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"transactionRule": {
"description": "The rules associated with this Transaction Configuration Set. Each rule is defined by the appId and, optionally, cmdCode both of which are found in the Diameter request message header. Each rule must have at least one applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, or routingOptionSetName defined.",
"items": {
"properties": {
"appId": {
"description": "The appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Transaction Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId value in this rule (and also matches the cmdCode, if this rule contains a cmdCode value), according to the applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, and routingOptionSetName values (whichever of the four are specified) configured in the rule. The value must be an integer in the range 0-4294967295.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"applicationRouteTableName": {
"description": "If provided, specifies the Application Route Table (/diameter/applicationroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cmdCode": {
"description": "If specified, identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match.",
"maxLength": 30,
"type": "string"
},
"peerRouteTableName": {
"description": "If provided, specifies the Peer Route Table (/diameter/peerroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "If provided, specifies the Pending Answer Timer (/diameter/pendinganswertimers) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingOptionSetName": {
"description": "If provided, specifies the Routing Option Set (/diameter/routingoptionsets) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"maxItems": 1000,
"minItems": 0,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"name": "TransactionConfigurationSet1",
"transactionConfigurationRule": {
"items": [{
"appId": 16777216,
"applicationRouteTableName": "OcdraART",
"cmdCode": "258",
"peerRouteTableName": "NGNPS",
"pendingAnswerTimerName": "sw_PAT_1",
"routingOptionSetName": "sw_ROS_1"
}, {
"appId": 3,
"applicationRouteTableName": "PdraART",
"cmdCode": "300.623.0",
"peerRouteTableName": "Radius",
"routingOptionSetName": "sw_ROS_2"
}, {
"appId": 4294967295,
"cmdCode": "265.274.1",
"pendingAnswerTimerName": "sw_PAT_3",
"routingOptionSetName": "sw_ROS_3"
}]
}
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/transactionconfigurationsets/{name}
Updates the configuration of the specified Transaction Configuration Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/transactionconfigurationset/transactionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Transaction Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"transactionRule": {
"description": "The rules associated with this Transaction Configuration Set. Each rule is defined by the appId and, optionally, cmdCode both of which are found in the Diameter request message header. Each rule must have at least one applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, or routingOptionSetName defined.",
"items": {
"properties": {
"appId": {
"description": "The appId defines the Diameter Application Id (/diameter/applicationids) to which this rule applies. Whenever the Transaction Configuration Set is used, the DSR routes request messages, whose Application Id matches the appId value in this rule (and also matches the cmdCode, if this rule contains a cmdCode value), according to the applicationRouteTableName, peerRouteTableName, pendingAnswerTimerName, and routingOptionSetName values (whichever of the four are specified) configured in the rule. The value must be an integer in the range 0-4294967295.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"applicationRouteTableName": {
"description": "If provided, specifies the Application Route Table (/diameter/applicationroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"cmdCode": {
"description": "If specified, identifies the Command Code (/diameter/commandcodes) that must be present in an ingress Diameter message (having an Application Id (/diameter/applicationids) value of appId) for this rule to match.",
"maxLength": 30,
"type": "string"
},
"peerRouteTableName": {
"description": "If provided, specifies the Peer Route Table (/diameter/peerroutetables) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pendingAnswerTimerName": {
"description": "If provided, specifies the Pending Answer Timer (/diameter/pendinganswertimers) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingOptionSetName": {
"description": "If provided, specifies the Routing Option Set (/diameter/routingoptionsets) the DSR uses when routing a Diameter message that matches the appId and optional cmdCode defined for this rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"appId"
],
"type": "object"
},
"maxItems": 1000,
"minItems": 0,
"type": "array"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"name": "TransactionConfigurationSet1",
"transactionConfigurationRule": {
"items": [{
"appId": 16777216,
"applicationRouteTableName": "OcdraART",
"cmdCode": "258",
"peerRouteTableName": "NGNPS",
"pendingAnswerTimerName": "sw_PAT_1",
"routingOptionSetName": "sw_ROS_1"
}, {
"appId": 3,
"applicationRouteTableName": "PdraART",
"cmdCode": "300.623.0",
"peerRouteTableName": "Radius",
"routingOptionSetName": "sw_ROS_2"
}, {
"appId": 4294967295,
"cmdCode": "265.274.1",
"pendingAnswerTimerName": "sw_PAT_3",
"routingOptionSetName": "sw_ROS_3"
}]
}
}
delete /diameter/transactionconfigurationsets/{name}
Deletes the specified Transaction Configuration Set from the SOAM configuration. The Default Transaction Configuration Set cannot be deleted. A Transaction Configuration Set can only be deleted if all delete validation checks pass. In general, if the Transaction Configuration Set is part of the configuration of one or more traffic throttle points (/diameter/trafficthrottlepoints), the Transaction Configuration Set cannot be deleted. If the Transaction Configuration Set is named in a TTP, the Transaction Configuration Set must first be removed from the TTP. Then the Transaction Configuration Set can be deleted from the configuration. An attempt to delete a Transaction Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Diameter: Topology Hiding Trusted Network Lists
Topology Hiding involves hiding topology-related information in messages sent from a Protected Network to an Untrusted Network, as well as restoring the topology-related information in messages from an Untrusted Network. The restoral process can occur during the same Diameter transaction or can occur on subsequent unrelated Diameter transactions.
A Trusted Network List is a list of Realms identifying networks where Topology Hiding is NOT invoked for messages to and from that network. Up to 500 Trusted Network Lists can be configured. Each Trusted Network List can contain up to 100 Trusted Network Realms.
All Trusted Network List configuration is done at the NOAM.
/diameter/trustednetworklists
get /diameter/trustednetworklists
Returns all Trusted Network Lists configured at the NOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Trusted Network Lists meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/trustednetworklistCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trustednetworklist/trustednetworklist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Trusted Network List, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"trustedRealm": {
"description": "Trusted Network Realms for this Trusted Network List. For Trusted Network Realms the Topology Hiding Feature is not applied. Trusted Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 100,
"type": "array"
}
},
"required": [
"name",
"trustedRealm"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "MmiTestTrustedNetwrokListi",
"trustedRealm": [
"oracle1.com",
"oracle2.com"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/trustednetworklists
Adds a new Trusted Network List to the DSR configuration. The new Trusted Network List must have a name that is unique to the NOAM configuration.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trustednetworklist/trustednetworklist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Trusted Network List, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"trustedRealm": {
"description": "Trusted Network Realms for this Trusted Network List. For Trusted Network Realms the Topology Hiding Feature is not applied. Trusted Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 100,
"type": "array"
}
},
"required": [
"name",
"trustedRealm"
],
"type": "object"
}
Example
{
"name": "MmiTestTrustedNetwrokListi",
"trustedRealm": [
"oracle1.com",
"oracle2.com"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/trustednetworklists/{name}
get /diameter/trustednetworklists/{name}
Returns the configuration details for the specified Trusted Network List. If the specified Trusted Network List does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/trustednetworklistItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trustednetworklist/trustednetworklist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Trusted Network List, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"trustedRealm": {
"description": "Trusted Network Realms for this Trusted Network List. For Trusted Network Realms the Topology Hiding Feature is not applied. Trusted Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 100,
"type": "array"
}
},
"required": [
"name",
"trustedRealm"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "MmiTestTrustedNetwrokListi",
"trustedRealm": [
"oracle1.com",
"oracle2.com"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/trustednetworklists/{name}
Updates the configuration for the specified Trusted Network List. If the provided Trusted Network List data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/trustednetworklist/trustednetworklist.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name for the Trusted Network List, which must be unique within the DSR site. Valid names are case-sensitive strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"minLength": 1,
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"trustedRealm": {
"description": "Trusted Network Realms for this Trusted Network List. For Trusted Network Realms the Topology Hiding Feature is not applied. Trusted Network Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes and underscore. A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long.",
"items": {
"minLength": 1,
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,62}[a-zA-Z0-9]\\.){0,62}(?!0-9+)[a-zA-Z0-9]{1,63}$",
"type": "string"
},
"minItems": 1,
"maxItems": 100,
"type": "array"
}
},
"required": [
"name",
"trustedRealm"
],
"type": "object"
}
Example
{
"name": "MmiTestTrustedNetwrokListi",
"trustedRealm": [
"oracle1.com",
"oracle2.com"
]
}
delete /diameter/trustednetworklists/{name}
Deletes the specified Trusted Network List from the NOAM configuration. A Trusted Network List can only be deleted if all delete validation checks pass.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Eir: IMSI Addresses
IMSI addresses are used to configure an equipment status for an IMSI range. An IMSI range is a combination of start address and end address. IMSI addresses can be used to bypass the IMEI check for certain IMSI ranges as defined by the operator.
All IMSI addresses (startAddr, endAddr, equipmentStatus) configuration is done at the SOAM.
/eir/imsiaddresses
get /eir/imsiaddresses
Returns all IMSI addresses configured.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/eir/collections/imsirangeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/eir/imsirange/imsirange.json",
"properties": {
"endAddr": {
"description": "End IMSI address for the IMSI range.",
"pattern": "^[0-9]{15}$",
"type": "string"
},
"equipmentStatus": {
"description": "Equipment status.",
"enum": [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"type": "string"
},
"startAddr": {
"description": "Start IMSI address for the IMSI range. This is used to uniquely identify an IMSI range record.",
"pattern": "^[0-9]{15}$",
"type": "string"
}
},
"required": [
"endAddr",
"equipmentStatus",
"startAddr"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"endAddr": "310150123456789",
"equipmentStatus": "Blacklist",
"startAddr": "310150123456711"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /eir/imsiaddresses
Adds a new IMSI range. There should not be any overlap with any existing range.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/eir/imsirange/imsirange.json",
"properties": {
"endAddr": {
"description": "End IMSI address for the IMSI range.",
"pattern": "^[0-9]{15}$",
"type": "string"
},
"equipmentStatus": {
"description": "Equipment status.",
"enum": [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"type": "string"
},
"startAddr": {
"description": "Start IMSI address for the IMSI range. This is used to uniquely identify an IMSI range record.",
"pattern": "^[0-9]{15}$",
"type": "string"
}
},
"required": [
"endAddr",
"equipmentStatus",
"startAddr"
],
"type": "object"
}
Example
{
"endAddr": "310150123456789",
"equipmentStatus": "Blacklist",
"startAddr": "310150123456711"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/eir/imsiaddresses/{startAddr}
get /eir/imsiaddresses/{startAddr}
Returns the IMSI range record for the specified startAddr. If the startAddr does not exist in the table, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- startAddr: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/eir/items/imsirangeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/eir/imsirange/imsirange.json",
"properties": {
"endAddr": {
"description": "End IMSI address for the IMSI range.",
"pattern": "^[0-9]{15}$",
"type": "string"
},
"equipmentStatus": {
"description": "Equipment status.",
"enum": [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"type": "string"
},
"startAddr": {
"description": "Start IMSI address for the IMSI range. This is used to uniquely identify an IMSI range record.",
"pattern": "^[0-9]{15}$",
"type": "string"
}
},
"required": [
"endAddr",
"equipmentStatus",
"startAddr"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"endAddr": "310150123456789",
"equipmentStatus": "Blacklist",
"startAddr": "310150123456711"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /eir/imsiaddresses/{startAddr}
Updates the IMSI range equipmentStatus and/or endAddr for the specified startAddr. There should not be any overlap with any existing range. If the IMSI range data is invalid, the update fails and an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- startAddr: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/eir/imsirange/imsirange.json",
"properties": {
"endAddr": {
"description": "End IMSI address for the IMSI range.",
"pattern": "^[0-9]{15}$",
"type": "string"
},
"equipmentStatus": {
"description": "Equipment status.",
"enum": [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"type": "string"
},
"startAddr": {
"description": "Start IMSI address for the IMSI range. This is used to uniquely identify an IMSI range record.",
"pattern": "^[0-9]{15}$",
"type": "string"
}
},
"required": [
"endAddr",
"equipmentStatus",
"startAddr"
],
"type": "object"
}
Example
{
"endAddr": "310150123456789",
"equipmentStatus": "Blacklist",
"startAddr": "310150123456711"
}
delete /eir/imsiaddresses/{startAddr}
Deletes the IMSI range for the specified startAddr. An attempt to delete an IMSI range which does not exist, results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- startAddr: required (string)
Eir: Options
The Equipment Identity Register (EIR) Options are those configuration values that govern the overall EIR functionality for VSTP and Diameter. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new EIR Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All EIR Options configuration is done at the SOAM.
/eir/options
get /eir/options
Returns the set of current values for the EIR Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/eir/items/optionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/eir/option/option.json",
"properties": {
"diameterCongErr": {
"description": "If the incoming messages running on DEIR exceed or connection capacity on DEIR is not able to process the messages, DAMP fails in processing messages and it shall discard the messages and respond with the configured value in the result code.",
"enum" : [
3004,
5006
],
"default": 3004,
"type": "integer"
},
"diameterProductName": {
"description": "This parameter is the vendor assigned name for the product. Currently only DSR is supported.",
"enum" : [
"DSR"
],
"default": "DSR",
"readOnly": true,
"type": "string"
},
"diameterVendorId": {
"description": "S13 local Vendor ID. All the outgoing messages that require Vendor ID in VENDOR_SPECIFIC_APPLICATION_ID will use this configured value. Currently only 10415 is supported, The CEA message will have 10415 in the response.",
"enum" : [
10415
],
"default": 10415,
"readOnly": true,
"type": "integer"
},
"eirDefImsiResp": {
"description": "Equipment Identity Register (EIR) default IMSI response.",
"enum" : [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"default" : "Whitelist",
"type": "string"
},
"eirDefMcc": {
"description": "E212 default mobile country code. It should support any 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{3}$|^(None)$",
"default" : "None",
"type": "string"
},
"eirDefMnc": {
"description": "E212 default mobile network code. It should support any 2 or 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{2,3}$|^(None)$",
"default" : "None",
"type": "string"
},
"eirDefRespInErr": {
"description": "Default Equipment Identity Register (EIR) Response status when EIR application is in Degraded state. EIR can be in degraded state due to connectivity to Offboard UDR is down or Congested.",
"enum" : [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"default" : "Whitelist",
"type": "string"
},
"eirGlobalResp": {
"description": "Equipment Identity Register (EIR) Global Response status.",
"enum" : [
"Blacklist",
"Off",
"Graylist",
"Unknown",
"Whitelist"
],
"default" : "Off",
"type": "string"
},
"eirImsiChk": {
"description": "Equipment Identity Register (EIR) IMSI Check status. This parameter is not valid for IMSI range.",
"default" : false,
"type": "boolean"
},
"eirImsiScrn": {
"description": "Specifies the use of Equipment Identity Register (EIR) IMSI screening status. This option specifies whether the IMSI Screening shall be done before the IMEI check.",
"default" : true,
"type": "boolean"
},
"eirLogWhitelist": {
"description": "Specifies whether the white list logging for Diameter Equipment Identity Register (EIR) shall be on. This option has a default of OFF.",
"default" : false,
"type": "boolean"
},
"eirRespType": {
"description": "Equipment Identity Register (EIR) Response Type.",
"enum" : [
"Type1",
"Type2",
"Type3"
],
"default" : "Type1",
"type": "string"
},
"eirSoftwareVerScrn": {
"description": "Specifies whether the Software version screening for Equipment Identity Register (EIR) shall be on. This option has a default of OFF.",
"default" : false,
"type": "boolean"
},
"ss7DefMapVer": {
"description": "Default MAP version.",
"enum" : [
"V1",
"V2",
"V3"
],
"default" : "V3",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"diameterCongErr": 3004,
"diameterProductName": "DSR",
"diameterVendorId": 10415,
"eirDefMcc": "None",
"eirDefMnc": "None",
"eirDefRespInErr": "Whitelist",
"eirDefImsiResp": "Whitelist",
"eirGlobalResp": "Off",
"eirImsiChk": false,
"eirImsiScrn": true,
"eirLogWhitelist": false,
"eirRespType": "Type1",
"eirSoftwareVerScrn": true,
"ss7DefMapVer": "V3"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /eir/options
Update the EIR Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/eir/option/option.json",
"properties": {
"diameterCongErr": {
"description": "If the incoming messages running on DEIR exceed or connection capacity on DEIR is not able to process the messages, DAMP fails in processing messages and it shall discard the messages and respond with the configured value in the result code.",
"enum" : [
3004,
5006
],
"default": 3004,
"type": "integer"
},
"diameterProductName": {
"description": "This parameter is the vendor assigned name for the product. Currently only DSR is supported.",
"enum" : [
"DSR"
],
"default": "DSR",
"readOnly": true,
"type": "string"
},
"diameterVendorId": {
"description": "S13 local Vendor ID. All the outgoing messages that require Vendor ID in VENDOR_SPECIFIC_APPLICATION_ID will use this configured value. Currently only 10415 is supported, The CEA message will have 10415 in the response.",
"enum" : [
10415
],
"default": 10415,
"readOnly": true,
"type": "integer"
},
"eirDefImsiResp": {
"description": "Equipment Identity Register (EIR) default IMSI response.",
"enum" : [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"default" : "Whitelist",
"type": "string"
},
"eirDefMcc": {
"description": "E212 default mobile country code. It should support any 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{3}$|^(None)$",
"default" : "None",
"type": "string"
},
"eirDefMnc": {
"description": "E212 default mobile network code. It should support any 2 or 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{2,3}$|^(None)$",
"default" : "None",
"type": "string"
},
"eirDefRespInErr": {
"description": "Default Equipment Identity Register (EIR) Response status when EIR application is in Degraded state. EIR can be in degraded state due to connectivity to Offboard UDR is down or Congested.",
"enum" : [
"Blacklist",
"Graylist",
"Unknown",
"Whitelist"
],
"default" : "Whitelist",
"type": "string"
},
"eirGlobalResp": {
"description": "Equipment Identity Register (EIR) Global Response status.",
"enum" : [
"Blacklist",
"Off",
"Graylist",
"Unknown",
"Whitelist"
],
"default" : "Off",
"type": "string"
},
"eirImsiChk": {
"description": "Equipment Identity Register (EIR) IMSI Check status. This parameter is not valid for IMSI range.",
"default" : false,
"type": "boolean"
},
"eirImsiScrn": {
"description": "Specifies the use of Equipment Identity Register (EIR) IMSI screening status. This option specifies whether the IMSI Screening shall be done before the IMEI check.",
"default" : true,
"type": "boolean"
},
"eirLogWhitelist": {
"description": "Specifies whether the white list logging for Diameter Equipment Identity Register (EIR) shall be on. This option has a default of OFF.",
"default" : false,
"type": "boolean"
},
"eirRespType": {
"description": "Equipment Identity Register (EIR) Response Type.",
"enum" : [
"Type1",
"Type2",
"Type3"
],
"default" : "Type1",
"type": "string"
},
"eirSoftwareVerScrn": {
"description": "Specifies whether the Software version screening for Equipment Identity Register (EIR) shall be on. This option has a default of OFF.",
"default" : false,
"type": "boolean"
},
"ss7DefMapVer": {
"description": "Default MAP version.",
"enum" : [
"V1",
"V2",
"V3"
],
"default" : "V3",
"type": "string"
}
},
"type": "object"
}
Example
{
"diameterCongErr": 3004,
"diameterProductName": "DSR",
"diameterVendorId": 10415,
"eirDefMcc": "None",
"eirDefMnc": "None",
"eirDefRespInErr": "Whitelist",
"eirDefImsiResp": "Whitelist",
"eirGlobalResp": "Off",
"eirImsiChk": false,
"eirImsiScrn": true,
"eirLogWhitelist": false,
"eirRespType": "Type1",
"eirSoftwareVerScrn": true,
"ss7DefMapVer": "V3"
}
Fabr: Address Resolutions
Address Resolutions allows to define the routing relationship between message content and an address by mapping a Diameter Application ID, Command Code, and Routing Entity Type to a user-configured address (a range or individual address). An Address Resolution supports up to three prioritized Routing Entity Types for each Application ID and Command Code (highest priority - Primary Routing Entity Type - and lowest priority - Tertiary Routing Entity Type).
/fabr/addressresolutions
get /fabr/addressresolutions
Returns all Address Resolutions configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Address Resolutions meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/collections/addressresolutionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"applIdCmdCodeId": {
"description": "The natural identifier for the Address Resolution instance .It is a combination of applId and cmdCode field values.",
"readOnly": true,
"pattern": "^(([0-9]*)-([A-Za-z0-9]))",
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"primaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"DeviceActionExternalId",
"UserIdentifierExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"secondaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"tertiaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityDestinationType",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityBlacklistSearchEnabled": false,
"primaryRoutingEntityDestinationType": "Ocs",
"primaryRoutingEntityFallbackSearchEnabled": false,
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityPrefixSearchEnabled": false,
"primaryRoutingEntitySecondaryAvp": "SvcInfoSubscrId1",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityDestinationType": "Ofcs",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /fabr/addressresolutions
Adds a new Address Resolution to the DSR configuration. The new Address Resolution must have an Application Id and Command Code combination that is unique to the SOAM's configuration
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"applIdCmdCodeId": {
"description": "The natural identifier for the Address Resolution instance .It is a combination of applId and cmdCode field values.",
"readOnly": true,
"pattern": "^(([0-9]*)-([A-Za-z0-9]))",
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"primaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"DeviceActionExternalId",
"UserIdentifierExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"secondaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"tertiaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityDestinationType",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
}
Example
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityBlacklistSearchEnabled": false,
"primaryRoutingEntityDestinationType": "Ocs",
"primaryRoutingEntityFallbackSearchEnabled": false,
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityPrefixSearchEnabled": false,
"primaryRoutingEntitySecondaryAvp": "SvcInfoSubscrId1",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityDestinationType": "Ofcs",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/fabr/addressresolutions/{id}
get /fabr/addressresolutions/{id}
Returns the configuration details for the specified Address Resolution. If the specified Address Resolution does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/items/addressresolutionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"applIdCmdCodeId": {
"description": "The natural identifier for the Address Resolution instance .It is a combination of applId and cmdCode field values.",
"readOnly": true,
"pattern": "^(([0-9]*)-([A-Za-z0-9]))",
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"primaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"DeviceActionExternalId",
"UserIdentifierExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"secondaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"tertiaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityDestinationType",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityBlacklistSearchEnabled": false,
"primaryRoutingEntityDestinationType": "Ocs",
"primaryRoutingEntityFallbackSearchEnabled": false,
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityPrefixSearchEnabled": false,
"primaryRoutingEntitySecondaryAvp": "SvcInfoSubscrId1",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityDestinationType": "Ofcs",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /fabr/addressresolutions/{id}
Updates the configuration for the specified Address Resolution. If the provided Address Resolution data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"applIdCmdCodeId": {
"description": "The natural identifier for the Address Resolution instance .It is a combination of applId and cmdCode field values.",
"readOnly": true,
"pattern": "^(([0-9]*)-([A-Za-z0-9]))",
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"primaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"DeviceActionExternalId",
"UserIdentifierExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"secondaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier).",
"enum": [
"Imsi",
"Impi",
"Impu",
"Msisdn",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityBlacklistSearchEnabled": {
"description": "If true, IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup. If the System Options 'BlackList Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityDestinationType": {
"description": "Type of Destination for this Routing Entity Type. Destination Entity can be entity (Ims-Hss, Lte-Hss, Mtc-Hss, Pcrf, Ocs, Ofcs, Aaa, UserDef1 or UserDef2).",
"enum": [
"Aaa",
"Ocs",
"Ofcs",
"Pcrf",
"ImsHss",
"LteHss",
"MtcHss",
"UserDefined1",
"UserDefined2"
],
"type": "string"
},
"tertiaryRoutingEntityFallBackSearchEnabled": {
"description": "If true, Domain-Identifier lookup will be performed, when extenal identifier lookup did not find an exact match. If the System Options 'Fallback Search Enabled' is false, then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed, if the full address lookup did not find a match. If the System Options 'Prefix Search Enabled' is false,then this attribute is ignored.",
"default": false,
"type": "boolean"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"DeviceActionExternalId",
"UserIdentifierUserName",
"UserIdentifierExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"Msisdn",
"UserName",
"PublicIdentity",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserIdentifierMsisdn",
"UserIdentifierUserName"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityDestinationType",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
}
Example
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityBlacklistSearchEnabled": false,
"primaryRoutingEntityDestinationType": "Ocs",
"primaryRoutingEntityFallbackSearchEnabled": false,
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityPrefixSearchEnabled": false,
"primaryRoutingEntitySecondaryAvp": "SvcInfoSubscrId1",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityDestinationType": "Ofcs",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn"
}
delete /fabr/addressresolutions/{id}
Deletes the specified Address Resolution from the SOAM configuration. An Address Resolution will only be deleted if all delete validation checks pass. If the Address Resolution is part of the configuration of some other Managed Object, the Address Resolution cannot be deleted.
Target Server: SOAM
Secured by x-other
Fabr: Default Destinations
Default Destinations contains the attributes associated with a destination to which FABR routes a message. FABR uses these attributes to modify the contents of a received message before forwarding the message. Each destination can be configured with any combination of a Realm and FQDN such as Realm-only, FQDN-only, or Realm and FQDN
/fabr/defaultdestinations
get /fabr/defaultdestinations
Returns all Default Destinations configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Destinations meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section)
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/collections/defaultdestinationCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/defaultdestination/defaultdestination.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"fqdn":"fqdn1.oracle.com",
"name":"AutomDestination1",
"realm":"oracle.com"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /fabr/defaultdestinations
Adds a new Destination to the FABR configuration. The new Destination must have a name that is unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/defaultdestination/defaultdestination.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"fqdn":"fqdn1.oracle.com",
"name":"AutomDestination1",
"realm":"oracle.com"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/fabr/defaultdestinations/{name}
get /fabr/defaultdestinations/{name}
Returns the configuration details for the specified Destination. If the specified Destination does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/items/defaultdestinationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/defaultdestination/defaultdestination.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"fqdn":"fqdn1.oracle.com",
"name":"AutomDestination1",
"realm":"oracle.com"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /fabr/defaultdestinations/{name}
Updates the configuration for the specified Destination. If the provided Destination data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/defaultdestination/defaultdestination.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"minLength": 1,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"fqdn":"fqdn1.oracle.com",
"name":"AutomDestination1",
"realm":"oracle.com"
}
delete /fabr/defaultdestinations/{name}
Deletes the specified Destination from the SOAM configuration. A Destination will only be deleted if all delete validation checks pass. If the Destination is part of the configuration of some other Managed Object, the Destination cannot be deleted. For example, if the Destination is associated with an Exception (/fabr/exception), that association must first be removed and then the Destination can be deleted from the configuration. An attempt to delete Destination that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Fabr: Options
Options (sometimes referred to as System Options) is a collection of parameters that govern various aspects of FABR global parameters.
There is a single instance of this resource, which contains all of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
/fabr/options
get /fabr/options
Returns the set of current values for the Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/items/optionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/option/option.json",
"properties": {
"allowSubsequentDSRAppInvoc": {
"description": "If set to true, subsequent invocation of FABR on a different node in the network is allowed.",
"default": false,
"type": "boolean"
},
"asciiExcludedList": {
"items": {
"description": "A list of ASCII characters to ignore while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"maxLength": 20,
"minLength": 1,
"type": "string",
"pattern": "^[0-9a-zA-Z\\(\\'\\)\\+\\-\\[\\]\\{\\}\\=\\!\\@\\#\\$\\^\\&\\*\\:\\;\\,\\<\\>\\?.\\/\\~\\`\"\\|]+$"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"blacklistSearchEnabled": {
"description": "If true then IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup.",
"default": false,
"type": "boolean"
},
"bundlingEnabled": {
"description": "If true, FABR will bundle DP query Events to form a DP Bundled query Event, which will be send to DP Server.",
"default": false,
"type": "boolean"
},
"DataBaseType": {
"description": "Set the database to be used by Fabr. (Note : Make sure the ComAgent Connections for the Fabr DataBaseType selection are up.)",
"enum": [
"SDS"
],
"default": "SDS",
"type": "string"
},
"excludeSpace": {
"description": "If set to true, ASCII character space is ignored while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"default": false,
"type": "boolean"
},
"fallbackSearchEnabled": {
"description": "If true then Domain-Identifier lookup will be performed, when external identifier lookup did not find an exact match.",
"default": false,
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"maximumBundleSize": {
"description": "Maximum number of individual DP query Events that can be bundled.",
"maximum": 20,
"minimum": 2,
"type": "integer"
},
"prefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed if the full address lookup did not find a match.",
"default": false,
"type": "boolean"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"removeDestHost": {
"description": "If set to true, FABR deletes any instance of 'Destination-Host' AVPs in the message when performing 'Realm only' resolution.",
"default": true,
"type": "boolean"
},
"resExhaustionErrCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhaustionErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"resExhaustionVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"tbcdExcludedList": {
"items": {
"description": "Character is ignored while parsing digits from a raw AVP data field of AVP Type OctetString encoded as a TBCD-string.",
"enum": ["*","#","a","b","c"],
"type": "string"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"unavailableAppAction": {
"description": "Action to be taken when FABR application is unavailable to process messages.",
"enum": [
"ContinueRouting",
"DefaultRoute",
"SendAnswer",
"SendAnsExp"
],
"default": "ContinueRouting",
"type": "string"
},
"unavailableAppErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of FABR application being unavailable.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"unavailableAppResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of FABR application being unavailable. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"unavailableAppRouteList": {
"description": "If the Unavailability Action is 'Default Route' and FABR application is not available, the requests will be routed using this Route List and Peer Routing Rules will be bypassed.",
"maxLength": 32,
"minLength": 0,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"unavailableAppVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of FABR application being unavailable.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"asciiExcludedList": "Default",
"allowSubsequentDSRAppInvoc": false,
"blacklistSearchEnabled": false,
"bundlingEnabled": false,
"DataBaseType": 'SDS',
"excludeSpace": false,
"fallbackSearchEnabled": false,
"fqdn": "fqdn1.oracle.com",
"maximumBundleSize": 5,
"prefixSearchEnabled": false,
"realm": "oracle.com",
"removeDestHost": true,
"resExhaustionErrCode": 3004,
"resExhaustionErrMsg": 'FABR Resource Exhausted',
"resExhaustionVendorId": 23,
"tbcdExcludedList": 'a',
"unavailableAppAction": 'SendAnsExp',
"unavailableAppErrMsg": "FABR Unavailable",
"unavailableAppRouteList": "Default",
"unavailableAppResultCode": 3002,
"unavailableAppVendorId": 23
},
"messages":
[
],
"links":
{
},
"status":
true
}
put /fabr/options
Updates the Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, and then PUT the Options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/option/option.json",
"properties": {
"allowSubsequentDSRAppInvoc": {
"description": "If set to true, subsequent invocation of FABR on a different node in the network is allowed.",
"default": false,
"type": "boolean"
},
"asciiExcludedList": {
"items": {
"description": "A list of ASCII characters to ignore while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"maxLength": 20,
"minLength": 1,
"type": "string",
"pattern": "^[0-9a-zA-Z\\(\\'\\)\\+\\-\\[\\]\\{\\}\\=\\!\\@\\#\\$\\^\\&\\*\\:\\;\\,\\<\\>\\?.\\/\\~\\`\"\\|]+$"
},
"maxItems": 10,
"minItems": 0,
"type": "array"
},
"blacklistSearchEnabled": {
"description": "If true then IMSI/MSISDN blacklist lookup will be performed prior to the full address lookup.",
"default": false,
"type": "boolean"
},
"bundlingEnabled": {
"description": "If true, FABR will bundle DP query Events to form a DP Bundled query Event, which will be send to DP Server.",
"default": false,
"type": "boolean"
},
"DataBaseType": {
"description": "Set the database to be used by Fabr. (Note : Make sure the ComAgent Connections for the Fabr DataBaseType selection are up.)",
"enum": [
"SDS"
],
"default": "SDS",
"type": "string"
},
"excludeSpace": {
"description": "If set to true, ASCII character space is ignored while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"default": false,
"type": "boolean"
},
"fallbackSearchEnabled": {
"description": "If true then Domain-Identifier lookup will be performed, when external identifier lookup did not find an exact match.",
"default": false,
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"maximumBundleSize": {
"description": "Maximum number of individual DP query Events that can be bundled.",
"maximum": 20,
"minimum": 2,
"type": "integer"
},
"prefixSearchEnabled": {
"description": "If true, IMSI/MSISDN prefix based lookup will be performed if the full address lookup did not find a match.",
"default": false,
"type": "boolean"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"removeDestHost": {
"description": "If set to true, FABR deletes any instance of 'Destination-Host' AVPs in the message when performing 'Realm only' resolution.",
"default": true,
"type": "boolean"
},
"resExhaustionErrCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhaustionErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"resExhaustionVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"tbcdExcludedList": {
"items": {
"description": "Character is ignored while parsing digits from a raw AVP data field of AVP Type OctetString encoded as a TBCD-string.",
"enum": ["*","#","a","b","c"],
"type": "string"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"unavailableAppAction": {
"description": "Action to be taken when FABR application is unavailable to process messages.",
"enum": [
"ContinueRouting",
"DefaultRoute",
"SendAnswer",
"SendAnsExp"
],
"default": "ContinueRouting",
"type": "string"
},
"unavailableAppErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of FABR application being unavailable.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"unavailableAppResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of FABR application being unavailable. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"unavailableAppRouteList": {
"description": "If the Unavailability Action is 'Default Route' and FABR application is not available, the requests will be routed using this Route List and Peer Routing Rules will be bypassed.",
"maxLength": 32,
"minLength": 0,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"unavailableAppVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of FABR application being unavailable.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [],
"type": "object"
}
Example
{
"asciiExcludedList": "Default",
"allowSubsequentDSRAppInvoc": false,
"blacklistSearchEnabled": false,
"bundlingEnabled": false,
"DataBaseType": 'SDS',
"excludeSpace": false,
"fallbackSearchEnabled": false,
"fqdn": "fqdn1.oracle.com",
"maximumBundleSize": 5,
"prefixSearchEnabled": false,
"realm": "oracle.com",
"removeDestHost": true,
"resExhaustionErrCode": 3004,
"resExhaustionErrMsg": 'FABR Resource Exhausted',
"resExhaustionVendorId": 23,
"tbcdExcludedList": 'a',
"unavailableAppAction": 'SendAnsExp',
"unavailableAppErrMsg": "FABR Unavailable",
"unavailableAppRouteList": "Default",
"unavailableAppResultCode": 3002,
"unavailableAppVendorId": 23
}
Response
HTTP status code 200
Fabr: Routing Exceptions
Exception (sometimes referred to as Routing Exception) allows you to specify the routing exception action to take when FABR is unable to resolve an address to a Destination for each supported Diameter Application and Routing Exception Type. There are three (3) Routing Exception entries (No Address Match, No valid Routing Entity Address, and Unknown Command Code) automatically inserted with the Routing Exception Action set to Forward Unchanged as the default action for a supported Diameter application entry when that application entry is added. Similarly, these Routing Exceptions that are associated with an application entry are automatically deleted when that application entry is deleted
/fabr/routingexceptions
get /fabr/routingexceptions
Returns all Routing Exception configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Routing Exception meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/collections/routingexceptionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/routingexception/routingexception.json",
"properties": {
"action": {
"description": "Action to be taken on exception.",
"enum": [
"AbandonRequest",
"FwdUnchanged",
"FwdToDest",
"SendAnswer",
"SendAnsExp"
],
"default": "FwdUnchanged",
"type": "string"
},
"ansResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message on exception. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"destName": {
"description": "Destination to which message will be forwarded on exception",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"errMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message on exception.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"exceptionType": {
"description": "Type of Routing Exception.",
"enum": [
"DpErrors",
"NoAddrMatch",
"DpCongestion",
"UnknownCmdCode",
"BlacklistedSubscriber",
"NoRoutingEntityAddress",
"NoDrtEntry"
],
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the routing exception instance. It is combination of applId and exceptionType field values.",
"readOnly": true,
"pattern": "^(([0-9]*)-(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"vendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message on exception.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"applId"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action": "FwdUnchanged",
"applId": 16777251,
"exceptionType": "NoRoutingEntityAddress"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
/fabr/routingexceptions/{id}
get /fabr/routingexceptions/{id}
Returns the configuration details for the specified Routing Exception. If the specified Routing Exception does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/items/routingexceptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/routingexception/routingexception.json",
"properties": {
"action": {
"description": "Action to be taken on exception.",
"enum": [
"AbandonRequest",
"FwdUnchanged",
"FwdToDest",
"SendAnswer",
"SendAnsExp"
],
"default": "FwdUnchanged",
"type": "string"
},
"ansResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message on exception. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"destName": {
"description": "Destination to which message will be forwarded on exception",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"errMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message on exception.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"exceptionType": {
"description": "Type of Routing Exception.",
"enum": [
"DpErrors",
"NoAddrMatch",
"DpCongestion",
"UnknownCmdCode",
"BlacklistedSubscriber",
"NoRoutingEntityAddress",
"NoDrtEntry"
],
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the routing exception instance. It is combination of applId and exceptionType field values.",
"readOnly": true,
"pattern": "^(([0-9]*)-(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"vendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message on exception.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"applId"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action": "FwdUnchanged",
"applId": 16777251,
"exceptionType": "NoRoutingEntityAddress"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /fabr/routingexceptions/{id}
Updates the Routing Exception with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, and then PUT the Options.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/routingexception/routingexception.json",
"properties": {
"action": {
"description": "Action to be taken on exception.",
"enum": [
"AbandonRequest",
"FwdUnchanged",
"FwdToDest",
"SendAnswer",
"SendAnsExp"
],
"default": "FwdUnchanged",
"type": "string"
},
"ansResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message on exception. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"readOnly": true,
"type": "integer"
},
"destName": {
"description": "Destination to which message will be forwarded on exception",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"errMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message on exception.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"exceptionType": {
"description": "Type of Routing Exception.",
"enum": [
"DpErrors",
"NoAddrMatch",
"DpCongestion",
"UnknownCmdCode",
"BlacklistedSubscriber",
"NoRoutingEntityAddress",
"NoDrtEntry"
],
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the routing exception instance. It is combination of applId and exceptionType field values.",
"readOnly": true,
"pattern": "^(([0-9]*)-(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"vendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message on exception.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"applId"
],
"type": "object"
}
Example
{
"action": "FwdUnchanged",
"applId": 16777251,
"exceptionType": "NoRoutingEntityAddress"
}
Fabr: Supported Applications
Applications(sometimes referred to as Supported Applications) allows user to access a list of Diameter Applications supported by FABR
/fabr/supportedapplications
get /fabr/supportedapplications
Returns all Applications configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Supported Applications meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/collections/supportedapplicationCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/supportedapplication/supportedapplication.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"routingMode": {
"description": "Routing Mode.",
"enum": [
"Proxy"
],
"default": "Proxy",
"type": "string"
}
},
"required": [
"applId"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"applId": 16777251,
"routingMode": "Proxy"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /fabr/supportedapplications
Adds a new Application to the FABR configuration. The new Application must be unique to the SOAM's configuration
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/supportedapplication/supportedapplication.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"routingMode": {
"description": "Routing Mode.",
"enum": [
"Proxy"
],
"default": "Proxy",
"type": "string"
}
},
"required": [
"applId"
],
"type": "object"
}
Example
{
"applId": 16777251,
"routingMode": "Proxy"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/fabr/supportedapplications/{id}
get /fabr/supportedapplications/{id}
Returns the configuration details for the specified Application. If the specified Application does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/items/supportedapplicationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/fabr/supportedapplication/supportedapplication.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"routingMode": {
"description": "Routing Mode.",
"enum": [
"Proxy"
],
"default": "Proxy",
"type": "string"
}
},
"required": [
"applId"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"applId": 16777251,
"routingMode": "Proxy"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /fabr/supportedapplications/{id}
Deletes the specified Application from the SOAM configuration. An Application will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Diameter: IPFE Options
The IP Front End (IPFE) Options are those configuration values that govern the overall IPFE functionality and are not directly related to any particular Target Set. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new IPFE Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All IPFE Options configuration is done at the SOAM.
/diameter/ipfeoptions
get /diameter/ipfeoptions
Returns the set of current values for the IPFE Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/ipfeoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ipfeoption/ipfeoption.json",
"properties": {
"clusterRebalancingAndAccounting": {
"description": "When set to true, support for cluster rebalancing and packet accounting in measurements is turned on. When set to false, such support is turned off. Typical value is true.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"globalPacketRateLimit": {
"description": "Overload throttling occurs whenever the combined packet rate for a single IPFE exceeds this value. Set to zero to disable overload throttling. When enabling overload throttling, the minimum allowable value is 10000 - the DSR rejects values between 1 and 9999, inclusive. Typical value is 500000.",
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"gratuitousArpType": {
"description": "Specifies the type of gratuitous ARP broadcast that is sent. Typical value is ArpRequest.",
"enum": [
"ArpRequest",
"ArpReply",
"ArpBoth"
],
"type": "string"
},
"imbalanceDetectionThroughputMinimum": {
"description": "The value, in packets/sec, below which no throughput analysis is performed regarding imbalance detection. Typical value is 20000.",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"ipfeA1IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-A1. Cannot be modified if any Target Set has IPFE-A1 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-A1 and IPFE-A2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipfeA2IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-A2. Cannot be modified if any Target Set has IPFE-A2 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-A1 and IPFE-A2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipfeB1IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-B1. Cannot be modified if any Target Set has IPFE-B1 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-B1 and IPFE-B2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipfeB2IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-B2. Cannot be modified if any Target Set has IPFE-B2 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-B1 and IPFE-B2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"leastLoadThreshold": {
"description": "The value, in packets/sec, below which least load selection reverts to round robin. Typical value is 1.",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"monitoringConnectionTimeout": {
"description": "Length of time to wait for a connection to complete when polling application servers for aliveness, in seconds. Typical value is 3.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"monitoringConnectionTryInterval": {
"description": "The interval between attempts to periodically connect to application servers and test for aliveness, in seconds. Typical value is 10.",
"maximum": 255,
"minimum": 1,
"type": "integer"
},
"monitoringPort": {
"description": "TCP port to use to attempt periodic connections or monitoring of application servers. Typical value is 9675.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"monitoringProtocol": {
"description": "The protocol used by IPFE to monitor application server aliveness. If any Target Set has load balancing set to least load, monitoringProtocol must be set to Heartbeat due to the need for load information in the monitoring packets. Typical value is Heartbeat.",
"enum": [
"Heartbeat",
"None"
],
"type": "string"
},
"sctpRejectOption": {
"description": "The action taken to reject SCTP connections when no application servers are available. Typical value is IcmpHostUnreachable.",
"enum": [
"Drop",
"IcmpAdminProhibited",
"IcmpHostUnreachable",
"IcmpPortUnreachable"
],
"type": "string"
},
"stateSyncReconnectInterval": {
"description": "The reconnect interval for syncing the kernel state between IPFEs, in seconds. Typical value is 1.",
"maximum": 255,
"minimum": 1,
"type": "integer"
},
"stateSyncTcpPort": {
"description": "The TCP port used for syncing kernel state between IPFEs. Typical value is 19041.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"tcpRejectOption": {
"description": "The action taken to reject TCP connections when no application servers are available. Typical value is TcpReset.",
"enum": [
"Drop",
"IcmpAdminProhibited",
"IcmpHostUnreachable",
"IcmpPortUnreachable",
"TcpReset"
],
"type": "string"
}
},
"required": [
"clusterRebalancingAndAccounting",
"globalPacketRateLimit",
"gratuitousArpType",
"imbalanceDetectionThroughputMinimum",
"leastLoadThreshold",
"monitoringConnectionTimeout",
"monitoringConnectionTryInterval",
"monitoringProtocol",
"sctpRejectOption",
"stateSyncReconnectInterval",
"tcpRejectOption"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"clusterRebalancingAndAccounting": true,
"configurationLevel": "47",
"globalPacketRateLimit": 500000,
"gratuitousArpType": "ArpRequest",
"imbalanceDetectionThroughputMinimum": 20000,
"ipfeA1IpAddress": "100.101.102.103",
"ipfeA2IpAddress": "100.101.102.104",
"ipfeB1IpAddress": "100.101.102.105",
"ipfeB2IpAddress": "100.101.102.106",
"leastLoadThreshold": 1,
"monitoringConnectionTimeout": 3,
"monitoringConnectionTryInterval": 10,
"monitoringPort": 9675,
"monitoringProtocol": "Heartbeat",
"sctpRejectOption": "IcmpPortUnreachable",
"stateSyncReconnectInterval": 1,
"stateSyncTcpPort": 19041,
"tcpRejectOption": "TcpReset"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /diameter/ipfeoptions
Updates the IPFE Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ipfeoption/ipfeoption.json",
"properties": {
"clusterRebalancingAndAccounting": {
"description": "When set to true, support for cluster rebalancing and packet accounting in measurements is turned on. When set to false, such support is turned off. Typical value is true.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"globalPacketRateLimit": {
"description": "Overload throttling occurs whenever the combined packet rate for a single IPFE exceeds this value. Set to zero to disable overload throttling. When enabling overload throttling, the minimum allowable value is 10000 - the DSR rejects values between 1 and 9999, inclusive. Typical value is 500000.",
"maximum": 10000000,
"minimum": 0,
"type": "integer"
},
"gratuitousArpType": {
"description": "Specifies the type of gratuitous ARP broadcast that is sent. Typical value is ArpRequest.",
"enum": [
"ArpRequest",
"ArpReply",
"ArpBoth"
],
"type": "string"
},
"imbalanceDetectionThroughputMinimum": {
"description": "The value, in packets/sec, below which no throughput analysis is performed regarding imbalance detection. Typical value is 20000.",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"ipfeA1IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-A1. Cannot be modified if any Target Set has IPFE-A1 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-A1 and IPFE-A2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipfeA2IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-A2. Cannot be modified if any Target Set has IPFE-A2 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-A1 and IPFE-A2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipfeB1IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-B1. Cannot be modified if any Target Set has IPFE-B1 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-B1 and IPFE-B2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipfeB2IpAddress": {
"description": "IPv4 or IPv6 address of IPFE-B2. Cannot be modified if any Target Set has IPFE-B2 selected as active. If IPFE functionality is being used, then at least one of the four IpAddress attributes must be set to a valid IPFE server IP address. If both IPFE-B1 and IPFE-B2 are used, they form a mated pair.",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"leastLoadThreshold": {
"description": "The value, in packets/sec, below which least load selection reverts to round robin. Typical value is 1.",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"monitoringConnectionTimeout": {
"description": "Length of time to wait for a connection to complete when polling application servers for aliveness, in seconds. Typical value is 3.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"monitoringConnectionTryInterval": {
"description": "The interval between attempts to periodically connect to application servers and test for aliveness, in seconds. Typical value is 10.",
"maximum": 255,
"minimum": 1,
"type": "integer"
},
"monitoringPort": {
"description": "TCP port to use to attempt periodic connections or monitoring of application servers. Typical value is 9675.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"monitoringProtocol": {
"description": "The protocol used by IPFE to monitor application server aliveness. If any Target Set has load balancing set to least load, monitoringProtocol must be set to Heartbeat due to the need for load information in the monitoring packets. Typical value is Heartbeat.",
"enum": [
"Heartbeat",
"None"
],
"type": "string"
},
"sctpRejectOption": {
"description": "The action taken to reject SCTP connections when no application servers are available. Typical value is IcmpHostUnreachable.",
"enum": [
"Drop",
"IcmpAdminProhibited",
"IcmpHostUnreachable",
"IcmpPortUnreachable"
],
"type": "string"
},
"stateSyncReconnectInterval": {
"description": "The reconnect interval for syncing the kernel state between IPFEs, in seconds. Typical value is 1.",
"maximum": 255,
"minimum": 1,
"type": "integer"
},
"stateSyncTcpPort": {
"description": "The TCP port used for syncing kernel state between IPFEs. Typical value is 19041.",
"maximum": 65535,
"minimum": 1,
"readOnly": true,
"type": "integer"
},
"tcpRejectOption": {
"description": "The action taken to reject TCP connections when no application servers are available. Typical value is TcpReset.",
"enum": [
"Drop",
"IcmpAdminProhibited",
"IcmpHostUnreachable",
"IcmpPortUnreachable",
"TcpReset"
],
"type": "string"
}
},
"required": [
"clusterRebalancingAndAccounting",
"globalPacketRateLimit",
"gratuitousArpType",
"imbalanceDetectionThroughputMinimum",
"leastLoadThreshold",
"monitoringConnectionTimeout",
"monitoringConnectionTryInterval",
"monitoringProtocol",
"sctpRejectOption",
"stateSyncReconnectInterval",
"tcpRejectOption"
],
"type": "object"
}
Example
{
"clusterRebalancingAndAccounting": true,
"configurationLevel": "47",
"globalPacketRateLimit": 500000,
"gratuitousArpType": "ArpRequest",
"imbalanceDetectionThroughputMinimum": 20000,
"ipfeA1IpAddress": "100.101.102.103",
"ipfeA2IpAddress": "100.101.102.104",
"ipfeB1IpAddress": "100.101.102.105",
"ipfeB2IpAddress": "100.101.102.106",
"leastLoadThreshold": 1,
"monitoringConnectionTimeout": 3,
"monitoringConnectionTryInterval": 10,
"monitoringPort": 9675,
"monitoringProtocol": "Heartbeat",
"sctpRejectOption": "IcmpPortUnreachable",
"stateSyncReconnectInterval": 1,
"stateSyncTcpPort": 19041,
"tcpRejectOption": "TcpReset"
}
Diameter: IPFE Target Sets
An IP Front End (IPFE) Target Set (TS) is a collection of DA-MPs (known as application servers within the IPFE context) that share the ingress traffic load associated with a publicly-exposed IP address. This publicly-exposed IP address is known as the Target Set Address (TSA). Each Target Set must have a primary TSA, and can optionally have a secondary TSA as well. The IP addresses of the DA-MP servers within the Target Set are thus hidden from DSR clients; a client knows the TSA(s), and remains unaware that more than one DA-MP could be handling request messages the client forwards to the DSR.
Each DSR can have up to 32 Target Sets configured, and each Target Set can include from one to sixteen DA-MPs. Any single DA-MP can be part of more than one Target Set. If a DA-MP is included in two or more Target Sets, those Target Sets are said to overlap, since they contain a shared application server.
The incoming request traffic is distributed by the IPFE across the DA-MPs in a Target Set according to the load balance algorithm configured for the Target Set.
All IPFE Options configuration is done at the SOAM.
/diameter/ipfetargetsets
get /diameter/ipfetargetsets
Returns all Target Sets that are configured at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/collections/ipfetargetsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ipfetargetset/ipfetargetset.json",
"properties": {
"allowedDeviation": {
"description": "The percentage within which two application servers are considered to be handling approximately equal load. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 5 percent.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"alternateIpAddress": {
"description": "A alternate IP address for the Target Set, also known as the alternate Target Set Address (TSA). The alternate TSA is optional. When SCTP is in use, this IP address serves as a non-primary protocol-linked failover address. When TCP is in use, DSR clients can use this an independent IP address with which to send requests. Whenever a alternate TSA is configured, each DA-MP in the Target Set must also provide a alternate IP address. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"alternatePreferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set's alternate TSA. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2. The value specified for alternatePreferredIpfeServer should not be the same as the value for primaryPreferredIpfeServer in order to provide an alternative path for SCTP dual-homed traffic. The pair letter (e.g., A, B) must match the pair letter specified by primaryPreferredIpfeServer.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"applicationServerIp": {
"description": "The list of application servers (DA-MPs) that make up this Target Set. The list of valid DA-MP IP addresses is provided in the /diameter/signalingipaddresses GET response. IP addresses having type LocalIp may be assigned as a Target Set's ipAddress or alternateIpAddress value.",
"items": {
"properties": {
"alternateIpAddress": {
"description": "Optional alternate IP address for the application server. The IP version of alternateIpAddress must match the IP version of ipAddress.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipAddress": {
"description": "IPv4 or IPv6 signaling address for the application server.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"serverDescription": {
"description": "Optional description for this application server.",
"maxLength": 64,
"type": "string"
},
"weight": {
"description": "Weighting factor, within the Target Set, for the application server associated with ipAddress/alternateIpAddress. Typical value is 100.",
"maximum": 65535,
"minimum": 0,
"type": "integer"
}
},
"required": [
"ipAddress",
"weight"
],
"type": "object"
},
"maxItems": 32,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"deleteAge": {
"description": "Value used for the Delete Age timer, in seconds. Recommendation is to set deleteAge no less than twice the Diameter watchdog timer value. Typical value is 600 seconds.",
"maximum": 3110400,
"minimum": 10,
"type": "integer"
},
"disabled": {
"description": "If true, the Target Set is disabled, but its configuration is preserved.",
"type": "boolean"
},
"ipAddress": {
"description": "The primary IP address for the Target Set, also known as the primary Target Set Address (TSA). This is the IP address DSR Peer Nodes (/diameter/peernodes) use when forwarding requests to the DSR. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"loadBalanceAlgorithm": {
"description": "The algorithm used to determine which DA-MP server is assigned each new Connection (/diameter/connections). When Hash is specified, load balancing is achieved by sending a new Connection to a DA-MP server based on hashing the originating port number and IP address. When LeastLoad is specified, load balancing is achieved through a calculation of which application server (DA-MP) currently has the least loading. Typical value is LeastLoad.",
"enum": [
"Hash",
"LeastLoad"
],
"type": "string"
},
"loadFactorConnectionCount": {
"description": "Defines the contribution (weighting factor) of Connection (/diameter/connections) count in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"loadFactorMps": {
"description": "Defines the contribution (weighting factor) of Messages per Second in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad.Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"number": {
"description": "The unique identifier for this Target Set. Must be an integer between 1 and 32, inclusive. Target Sets must be inserted beginning with number 1, and increasing in numerical order.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"peerNodeAwareEnabled": {
"description": "When set to true, the IPFE distributes Connections (/diameter/connections) from the same Peer Node Group (/diameter/peernodegroups) across servers in the Target Set to provide server redundancy for that group of Peer Nodes. The IPFE keeps a group count of the Connections from a Peer Node Group to each application server in the Target Set. Application servers with a group count difference that is equal to or greater than peerNodeGroupDistributionThreshold are generally not considered. For example, if peerNodeGroupDistributionThreshold is 1, the effect is to send a new Connection to the application server with the lowest group count. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is true.",
"type": "boolean"
},
"peerNodeGroupDistributionThreshold": {
"description": "Threshold used when assessing group count values for application servers. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 1.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"preferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"protocols": {
"description": "The protocol(s) the Target Set supports. If SctpAndTcp is specified, both SCTP and TCP are supported.",
"enum": [
"Sctp",
"Tcp",
"SctpAndTcp"
],
"type": "string"
}
},
"required": [
"deleteAge",
"disabled",
"loadBalanceAlgorithm",
"number",
"ipAddress",
"preferredIpfeServer",
"protocols"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"allowedDeviation": 5,
"alternateIpAddress": "101.102.103.11",
"alternatePreferredIpfeServer": "IpfeB1",
"applicationServerIp": [
{
"alternateIpAddress": "101.102.103.114",
"ipAddress": "101.102.103.104",
"serverDescription": "DAMP1",
"weight": 50
},
{
"alternateIpAddress": "101.102.103.115",
"ipAddress": "101.102.103.105",
"serverDescription": "DAMP2",
"weight": 50
}
],
"configurationLevel": "397",
"deleteAge": 600,
"disabled": false,
"ipAddress": "101.102.103.10",
"loadBalanceAlgorithm": "LeastLoad",
"loadFactorConnectionCount": 20,
"loadFactorMps": 80,
"number": 7,
"peerNodeAwareEnabled": false,
"peerNodeGroupDistributionThreshold": 1,
"preferredIpfeServer": "IpfeA2",
"protocols": "SctpAndTcp"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /diameter/ipfetargetsets
Adds a new Target Set to the DSR configuration. Target Sets do not have names; a Target Set's ID is an integer between 1 and 32, inclusive.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ipfetargetset/ipfetargetset.json",
"properties": {
"allowedDeviation": {
"description": "The percentage within which two application servers are considered to be handling approximately equal load. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 5 percent.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"alternateIpAddress": {
"description": "A alternate IP address for the Target Set, also known as the alternate Target Set Address (TSA). The alternate TSA is optional. When SCTP is in use, this IP address serves as a non-primary protocol-linked failover address. When TCP is in use, DSR clients can use this an independent IP address with which to send requests. Whenever a alternate TSA is configured, each DA-MP in the Target Set must also provide a alternate IP address. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"alternatePreferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set's alternate TSA. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2. The value specified for alternatePreferredIpfeServer should not be the same as the value for primaryPreferredIpfeServer in order to provide an alternative path for SCTP dual-homed traffic. The pair letter (e.g., A, B) must match the pair letter specified by primaryPreferredIpfeServer.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"applicationServerIp": {
"description": "The list of application servers (DA-MPs) that make up this Target Set. The list of valid DA-MP IP addresses is provided in the /diameter/signalingipaddresses GET response. IP addresses having type LocalIp may be assigned as a Target Set's ipAddress or alternateIpAddress value.",
"items": {
"properties": {
"alternateIpAddress": {
"description": "Optional alternate IP address for the application server. The IP version of alternateIpAddress must match the IP version of ipAddress.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipAddress": {
"description": "IPv4 or IPv6 signaling address for the application server.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"serverDescription": {
"description": "Optional description for this application server.",
"maxLength": 64,
"type": "string"
},
"weight": {
"description": "Weighting factor, within the Target Set, for the application server associated with ipAddress/alternateIpAddress. Typical value is 100.",
"maximum": 65535,
"minimum": 0,
"type": "integer"
}
},
"required": [
"ipAddress",
"weight"
],
"type": "object"
},
"maxItems": 32,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"deleteAge": {
"description": "Value used for the Delete Age timer, in seconds. Recommendation is to set deleteAge no less than twice the Diameter watchdog timer value. Typical value is 600 seconds.",
"maximum": 3110400,
"minimum": 10,
"type": "integer"
},
"disabled": {
"description": "If true, the Target Set is disabled, but its configuration is preserved.",
"type": "boolean"
},
"ipAddress": {
"description": "The primary IP address for the Target Set, also known as the primary Target Set Address (TSA). This is the IP address DSR Peer Nodes (/diameter/peernodes) use when forwarding requests to the DSR. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"loadBalanceAlgorithm": {
"description": "The algorithm used to determine which DA-MP server is assigned each new Connection (/diameter/connections). When Hash is specified, load balancing is achieved by sending a new Connection to a DA-MP server based on hashing the originating port number and IP address. When LeastLoad is specified, load balancing is achieved through a calculation of which application server (DA-MP) currently has the least loading. Typical value is LeastLoad.",
"enum": [
"Hash",
"LeastLoad"
],
"type": "string"
},
"loadFactorConnectionCount": {
"description": "Defines the contribution (weighting factor) of Connection (/diameter/connections) count in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"loadFactorMps": {
"description": "Defines the contribution (weighting factor) of Messages per Second in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad.Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"number": {
"description": "The unique identifier for this Target Set. Must be an integer between 1 and 32, inclusive. Target Sets must be inserted beginning with number 1, and increasing in numerical order.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"peerNodeAwareEnabled": {
"description": "When set to true, the IPFE distributes Connections (/diameter/connections) from the same Peer Node Group (/diameter/peernodegroups) across servers in the Target Set to provide server redundancy for that group of Peer Nodes. The IPFE keeps a group count of the Connections from a Peer Node Group to each application server in the Target Set. Application servers with a group count difference that is equal to or greater than peerNodeGroupDistributionThreshold are generally not considered. For example, if peerNodeGroupDistributionThreshold is 1, the effect is to send a new Connection to the application server with the lowest group count. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is true.",
"type": "boolean"
},
"peerNodeGroupDistributionThreshold": {
"description": "Threshold used when assessing group count values for application servers. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 1.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"preferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"protocols": {
"description": "The protocol(s) the Target Set supports. If SctpAndTcp is specified, both SCTP and TCP are supported.",
"enum": [
"Sctp",
"Tcp",
"SctpAndTcp"
],
"type": "string"
}
},
"required": [
"deleteAge",
"disabled",
"loadBalanceAlgorithm",
"number",
"ipAddress",
"preferredIpfeServer",
"protocols"
],
"type": "object"
}
Example
{
"allowedDeviation": 5,
"alternateIpAddress": "101.102.103.11",
"alternatePreferredIpfeServer": "IpfeB1",
"applicationServerIp": [
{
"alternateIpAddress": "101.102.103.114",
"ipAddress": "101.102.103.104",
"serverDescription": "DAMP1",
"weight": 50
},
{
"alternateIpAddress": "101.102.103.115",
"ipAddress": "101.102.103.105",
"serverDescription": "DAMP2",
"weight": 50
}
],
"configurationLevel": "397",
"deleteAge": 600,
"disabled": false,
"ipAddress": "101.102.103.10",
"loadBalanceAlgorithm": "LeastLoad",
"loadFactorConnectionCount": 20,
"loadFactorMps": 80,
"number": 7,
"peerNodeAwareEnabled": false,
"peerNodeGroupDistributionThreshold": 1,
"preferredIpfeServer": "IpfeA2",
"protocols": "SctpAndTcp"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/diameter/ipfetargetsets/{id}
get /diameter/ipfetargetsets/{id}
Returns the configuration details for the specified Target Set. If the specified Target Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response. This could happen if a request is made for Target Set 11, for example, but Target Set 11 is not part of the DSR configuration.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/items/ipfetargetsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ipfetargetset/ipfetargetset.json",
"properties": {
"allowedDeviation": {
"description": "The percentage within which two application servers are considered to be handling approximately equal load. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 5 percent.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"alternateIpAddress": {
"description": "A alternate IP address for the Target Set, also known as the alternate Target Set Address (TSA). The alternate TSA is optional. When SCTP is in use, this IP address serves as a non-primary protocol-linked failover address. When TCP is in use, DSR clients can use this an independent IP address with which to send requests. Whenever a alternate TSA is configured, each DA-MP in the Target Set must also provide a alternate IP address. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"alternatePreferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set's alternate TSA. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2. The value specified for alternatePreferredIpfeServer should not be the same as the value for primaryPreferredIpfeServer in order to provide an alternative path for SCTP dual-homed traffic. The pair letter (e.g., A, B) must match the pair letter specified by primaryPreferredIpfeServer.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"applicationServerIp": {
"description": "The list of application servers (DA-MPs) that make up this Target Set. The list of valid DA-MP IP addresses is provided in the /diameter/signalingipaddresses GET response. IP addresses having type LocalIp may be assigned as a Target Set's ipAddress or alternateIpAddress value.",
"items": {
"properties": {
"alternateIpAddress": {
"description": "Optional alternate IP address for the application server. The IP version of alternateIpAddress must match the IP version of ipAddress.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipAddress": {
"description": "IPv4 or IPv6 signaling address for the application server.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"serverDescription": {
"description": "Optional description for this application server.",
"maxLength": 64,
"type": "string"
},
"weight": {
"description": "Weighting factor, within the Target Set, for the application server associated with ipAddress/alternateIpAddress. Typical value is 100.",
"maximum": 65535,
"minimum": 0,
"type": "integer"
}
},
"required": [
"ipAddress",
"weight"
],
"type": "object"
},
"maxItems": 32,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"deleteAge": {
"description": "Value used for the Delete Age timer, in seconds. Recommendation is to set deleteAge no less than twice the Diameter watchdog timer value. Typical value is 600 seconds.",
"maximum": 3110400,
"minimum": 10,
"type": "integer"
},
"disabled": {
"description": "If true, the Target Set is disabled, but its configuration is preserved.",
"type": "boolean"
},
"ipAddress": {
"description": "The primary IP address for the Target Set, also known as the primary Target Set Address (TSA). This is the IP address DSR Peer Nodes (/diameter/peernodes) use when forwarding requests to the DSR. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"loadBalanceAlgorithm": {
"description": "The algorithm used to determine which DA-MP server is assigned each new Connection (/diameter/connections). When Hash is specified, load balancing is achieved by sending a new Connection to a DA-MP server based on hashing the originating port number and IP address. When LeastLoad is specified, load balancing is achieved through a calculation of which application server (DA-MP) currently has the least loading. Typical value is LeastLoad.",
"enum": [
"Hash",
"LeastLoad"
],
"type": "string"
},
"loadFactorConnectionCount": {
"description": "Defines the contribution (weighting factor) of Connection (/diameter/connections) count in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"loadFactorMps": {
"description": "Defines the contribution (weighting factor) of Messages per Second in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad.Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"number": {
"description": "The unique identifier for this Target Set. Must be an integer between 1 and 32, inclusive. Target Sets must be inserted beginning with number 1, and increasing in numerical order.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"peerNodeAwareEnabled": {
"description": "When set to true, the IPFE distributes Connections (/diameter/connections) from the same Peer Node Group (/diameter/peernodegroups) across servers in the Target Set to provide server redundancy for that group of Peer Nodes. The IPFE keeps a group count of the Connections from a Peer Node Group to each application server in the Target Set. Application servers with a group count difference that is equal to or greater than peerNodeGroupDistributionThreshold are generally not considered. For example, if peerNodeGroupDistributionThreshold is 1, the effect is to send a new Connection to the application server with the lowest group count. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is true.",
"type": "boolean"
},
"peerNodeGroupDistributionThreshold": {
"description": "Threshold used when assessing group count values for application servers. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 1.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"preferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"protocols": {
"description": "The protocol(s) the Target Set supports. If SctpAndTcp is specified, both SCTP and TCP are supported.",
"enum": [
"Sctp",
"Tcp",
"SctpAndTcp"
],
"type": "string"
}
},
"required": [
"deleteAge",
"disabled",
"loadBalanceAlgorithm",
"number",
"ipAddress",
"preferredIpfeServer",
"protocols"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"allowedDeviation": 5,
"alternateIpAddress": "101.102.103.11",
"alternatePreferredIpfeServer": "IpfeB1",
"applicationServerIp": [
{
"alternateIpAddress": "101.102.103.114",
"ipAddress": "101.102.103.104",
"serverDescription": "DAMP1",
"weight": 50
},
{
"alternateIpAddress": "101.102.103.115",
"ipAddress": "101.102.103.105",
"serverDescription": "DAMP2",
"weight": 50
}
],
"configurationLevel": "397",
"deleteAge": 600,
"disabled": false,
"ipAddress": "101.102.103.10",
"loadBalanceAlgorithm": "LeastLoad",
"loadFactorConnectionCount": 20,
"loadFactorMps": 80,
"number": 7,
"peerNodeAwareEnabled": false,
"peerNodeGroupDistributionThreshold": 1,
"preferredIpfeServer": "IpfeA2",
"protocols": "SctpAndTcp"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /diameter/ipfetargetsets/{id}
Updates the configuration for the specified Target Set. If the provided Target Set data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/diameter/ipfetargetset/ipfetargetset.json",
"properties": {
"allowedDeviation": {
"description": "The percentage within which two application servers are considered to be handling approximately equal load. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 5 percent.",
"maximum": 50,
"minimum": 0,
"type": "integer"
},
"alternateIpAddress": {
"description": "A alternate IP address for the Target Set, also known as the alternate Target Set Address (TSA). The alternate TSA is optional. When SCTP is in use, this IP address serves as a non-primary protocol-linked failover address. When TCP is in use, DSR clients can use this an independent IP address with which to send requests. Whenever a alternate TSA is configured, each DA-MP in the Target Set must also provide a alternate IP address. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"alternatePreferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set's alternate TSA. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2. The value specified for alternatePreferredIpfeServer should not be the same as the value for primaryPreferredIpfeServer in order to provide an alternative path for SCTP dual-homed traffic. The pair letter (e.g., A, B) must match the pair letter specified by primaryPreferredIpfeServer.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"applicationServerIp": {
"description": "The list of application servers (DA-MPs) that make up this Target Set. The list of valid DA-MP IP addresses is provided in the /diameter/signalingipaddresses GET response. IP addresses having type LocalIp may be assigned as a Target Set's ipAddress or alternateIpAddress value.",
"items": {
"properties": {
"alternateIpAddress": {
"description": "Optional alternate IP address for the application server. The IP version of alternateIpAddress must match the IP version of ipAddress.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"ipAddress": {
"description": "IPv4 or IPv6 signaling address for the application server.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"serverDescription": {
"description": "Optional description for this application server.",
"maxLength": 64,
"type": "string"
},
"weight": {
"description": "Weighting factor, within the Target Set, for the application server associated with ipAddress/alternateIpAddress. Typical value is 100.",
"maximum": 65535,
"minimum": 0,
"type": "integer"
}
},
"required": [
"ipAddress",
"weight"
],
"type": "object"
},
"maxItems": 32,
"type": "array"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"deleteAge": {
"description": "Value used for the Delete Age timer, in seconds. Recommendation is to set deleteAge no less than twice the Diameter watchdog timer value. Typical value is 600 seconds.",
"maximum": 3110400,
"minimum": 10,
"type": "integer"
},
"disabled": {
"description": "If true, the Target Set is disabled, but its configuration is preserved.",
"type": "boolean"
},
"ipAddress": {
"description": "The primary IP address for the Target Set, also known as the primary Target Set Address (TSA). This is the IP address DSR Peer Nodes (/diameter/peernodes) use when forwarding requests to the DSR. Must be a valid IPv4 or IPv6 address.",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"loadBalanceAlgorithm": {
"description": "The algorithm used to determine which DA-MP server is assigned each new Connection (/diameter/connections). When Hash is specified, load balancing is achieved by sending a new Connection to a DA-MP server based on hashing the originating port number and IP address. When LeastLoad is specified, load balancing is achieved through a calculation of which application server (DA-MP) currently has the least loading. Typical value is LeastLoad.",
"enum": [
"Hash",
"LeastLoad"
],
"type": "string"
},
"loadFactorConnectionCount": {
"description": "Defines the contribution (weighting factor) of Connection (/diameter/connections) count in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"loadFactorMps": {
"description": "Defines the contribution (weighting factor) of Messages per Second in the computation of application server load. The sum of loadFactorConnectionCount and loadFactorMps is normalized to 100 by the DSR. Only applies when the loadBalanceAlgorithm is LeastLoad.Typical value is 50.",
"maximum": 100,
"minimum": 0,
"type": "integer"
},
"number": {
"description": "The unique identifier for this Target Set. Must be an integer between 1 and 32, inclusive. Target Sets must be inserted beginning with number 1, and increasing in numerical order.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"peerNodeAwareEnabled": {
"description": "When set to true, the IPFE distributes Connections (/diameter/connections) from the same Peer Node Group (/diameter/peernodegroups) across servers in the Target Set to provide server redundancy for that group of Peer Nodes. The IPFE keeps a group count of the Connections from a Peer Node Group to each application server in the Target Set. Application servers with a group count difference that is equal to or greater than peerNodeGroupDistributionThreshold are generally not considered. For example, if peerNodeGroupDistributionThreshold is 1, the effect is to send a new Connection to the application server with the lowest group count. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is true.",
"type": "boolean"
},
"peerNodeGroupDistributionThreshold": {
"description": "Threshold used when assessing group count values for application servers. Only applies when the loadBalanceAlgorithm is LeastLoad. Typical value is 1.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"preferredIpfeServer": {
"description": "The IPFE server that primarily handles traffic for this Target Set. If this IPFE server fails, then its mate takes over. IPFE-A1 & IPFE-A2 are mates, as are IPFE-B1 & IPFE-B2.",
"enum": [
"IpfeA1",
"IpfeA2",
"IpfeB1",
"IpfeB2"
],
"type": "string"
},
"protocols": {
"description": "The protocol(s) the Target Set supports. If SctpAndTcp is specified, both SCTP and TCP are supported.",
"enum": [
"Sctp",
"Tcp",
"SctpAndTcp"
],
"type": "string"
}
},
"required": [
"deleteAge",
"disabled",
"loadBalanceAlgorithm",
"number",
"ipAddress",
"preferredIpfeServer",
"protocols"
],
"type": "object"
}
Example
{
"allowedDeviation": 5,
"alternateIpAddress": "101.102.103.11",
"alternatePreferredIpfeServer": "IpfeB1",
"applicationServerIp": [
{
"alternateIpAddress": "101.102.103.114",
"ipAddress": "101.102.103.104",
"serverDescription": "DAMP1",
"weight": 50
},
{
"alternateIpAddress": "101.102.103.115",
"ipAddress": "101.102.103.105",
"serverDescription": "DAMP2",
"weight": 50
}
],
"configurationLevel": "397",
"deleteAge": 600,
"disabled": false,
"ipAddress": "101.102.103.10",
"loadBalanceAlgorithm": "LeastLoad",
"loadFactorConnectionCount": 20,
"loadFactorMps": 80,
"number": 7,
"peerNodeAwareEnabled": false,
"peerNodeGroupDistributionThreshold": 1,
"preferredIpfeServer": "IpfeA2",
"protocols": "SctpAndTcp"
}
delete /diameter/ipfetargetsets/{id}
Deletes the specified Target Set from the SOAM configuration.
Target Server: SOAM
Secured by x-other
Mon: Active Alarms
Alarms are possibly service-impacting system events, and are classified into four severities: critical, major, minor, clear.
There is no natural identifier for an alarm. Typically a unique alarm can be isolated in the collection using its hostname, timestamp, and sequence number (seqno). The alarm service provides a generated identifier consisting of a hash of these three piece of information.
Alarm data is scoped to a server. When performing an unfiltered GET request at the NOAM, A-scoped alarms for all servers in the entire topology are visible. Performing an unfiltered GET request at an SOAM retrieves B-scoped alarms for the servers located at that site, as well as any A-scoped alarms generated by that site's servers.
/mon/alarms
get /mon/alarms
Retrieves all active alarms that meet the request parameters.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- time_unit: (one of minutes, hours, days)
The unit of time associated with time_count, which defines the total interval of time relative to time_date for which data is returned. For example, if time_unit is hours, and time_count is +5, then data is returned for the five hour period beginning with and subsequent to time_date.
Example:
?time_unit=minutes&time_count=-5&time_date=now
- time_count: (integer)
Specifies the number of time_units for which data is returned, relative to time_date. A - preceding the time_count integer means the data is returned for time preceding time_date; a + preceding the time_count integer means the data is returned for time following time_date. For example, if time_count is -10 and time_unit is minutes, then data is returned for the ten minute period preceding (and thus ending with) time_date.
Example:
?time_date=now&time_count=-2&time_unit=days
- time_date: (string - pattern: ^(now|([0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}))$)
The point in time that defines the fixed endpoint for which data is returned. The values for time_count and time_unit define the total interval of time for which data is returned, relative to the time_date value. time_date can be specified by the string "now", or as a specific date date/time using the ISO 8601 format: YYYY-MM-DD[T]hh:mm. e.g. 2016-11-21T11:34 For example if time_date is "2017-01-30T12:00" then data is returned for the items which occurred prior to "2017-01-30T12:00". If time_date is not supplied as a query parameter, its value defaults to "now".
Example:
...&time_date=2015-08-15T14:34&...
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/alarmCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/alarm/alarm.json",
"type" : "object",
"required": [
"id", "server", "timestamp", "severity", "eventNumber",
"seqNum", "name", "description", "product",
"type", "process", "instance", "errInfo"
],
"properties" : {
"id" : {
"type": "string",
"description": "Base 64 encoded alarm ID (generated)",
"pattern": "^[a-zA-Z0-9+/=]+$"
},
"server" : {
"type": "string",
"description": "Server on which the alarm was raised"
},
"timestamp" : {
"type": "string",
"description": "Timestamp of when the alarm was raised in an ISO 8601 format"
},
"index" : {
"type": "integer",
"description": "the position of this record in the data stream"
},
"severity" : {
"type": "string",
"description": "The severity of the alarm",
"enum": [
"Critical",
"Major",
"Minor"
]
},
"eventNumber" : {
"type": "integer",
"description": "Alarm description"
},
"seqNum" : {
"type": "integer",
"description": "Alarm sequence number"
},
"name" : {
"type": "string",
"description": "Alarm name"
},
"description" : {
"type": "string",
"description": "Alarm description"
},
"product" : {
"type": "string",
"description": "Alarm product"
},
"type" : {
"type": "string",
"description": "Type of the alarm"
},
"process" : {
"type": "string",
"description": "Alarm process"
},
"instance" : {
"type": "string",
"description": "Alarm instance"
},
"errInfo" : {
"type": "string",
"description": "Detailed info"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"id": "cnVieS1ub2IsMTU4MDUxMTMxMTcwMTI3ODgwMQ==",
"server": "ruby-nob",
"timestamp": "2016-08-23T11:24:24.024182865-04:00",
"index": 1580776586674232864,
"severity": "Minor",
"eventNumber": 10075,
"seqNum": 8,
"name": "Application processes have been manually stopped",
"description": "The server is no longer providing services because application processes have been manually stopped",
"product": "OAM",
"type": "HA",
"process": "oampAgent",
"instance": "oampAgent",
"errInfo": "\n GN_WARNING/WRN Application is Stopped Manually.\n ^^ [17702:ProcCtlResponder.C:703]\n\n"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/alarms/{id}
get /mon/alarms/{id}
Retrieves a specific active alarm. Attempting to retrieve an alarm that has cleared, or which has cleared and been reasserted does not return anything, because the second instance has a different timestamp than the original instance, and thus has a different instance identifier.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/alarmItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/alarm/alarm.json",
"type" : "object",
"required": [
"id", "server", "timestamp", "severity", "eventNumber",
"seqNum", "name", "description", "product",
"type", "process", "instance", "errInfo"
],
"properties" : {
"id" : {
"type": "string",
"description": "Base 64 encoded alarm ID (generated)",
"pattern": "^[a-zA-Z0-9+/=]+$"
},
"server" : {
"type": "string",
"description": "Server on which the alarm was raised"
},
"timestamp" : {
"type": "string",
"description": "Timestamp of when the alarm was raised in an ISO 8601 format"
},
"index" : {
"type": "integer",
"description": "the position of this record in the data stream"
},
"severity" : {
"type": "string",
"description": "The severity of the alarm",
"enum": [
"Critical",
"Major",
"Minor"
]
},
"eventNumber" : {
"type": "integer",
"description": "Alarm description"
},
"seqNum" : {
"type": "integer",
"description": "Alarm sequence number"
},
"name" : {
"type": "string",
"description": "Alarm name"
},
"description" : {
"type": "string",
"description": "Alarm description"
},
"product" : {
"type": "string",
"description": "Alarm product"
},
"type" : {
"type": "string",
"description": "Type of the alarm"
},
"process" : {
"type": "string",
"description": "Alarm process"
},
"instance" : {
"type": "string",
"description": "Alarm instance"
},
"errInfo" : {
"type": "string",
"description": "Detailed info"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "cnVieS1ub2IsMTU4MDUxMTMxMTcwMTI3ODgwMQ==",
"server": "ruby-nob",
"timestamp": "2016-08-23T11:24:24.024182865-04:00",
"index": 1580776586674232864,
"severity": "Minor",
"eventNumber": 10075,
"seqNum": 8,
"name": "Application processes have been manually stopped",
"description": "The server is no longer providing services because application processes have been manually stopped",
"product": "OAM",
"type": "HA",
"process": "oampAgent",
"instance": "oampAgent",
"errInfo": "\n GN_WARNING/WRN Application is Stopped Manually.\n ^^ [17702:ProcCtlResponder.C:703]\n\n"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Mon: Alarms and Events History
Alarms are possibly service-impacting system events, and are classified into four severities: critical, major, minor, clear.
When performing an filtered GET request at the NOAM, A-scoped alarms for all servers in the entire topology are visible. Performing an filtered GET request at an SOAM retrieves B-scoped alarms for the servers located at that site, as well as any A-scoped alarms generated by that site's servers.
/mon/alarmseventshistory
get /mon/alarmseventshistory
Retrieves all alarms and events history that meet the request parameters.It does not support any other operation.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- time_unit: (one of minutes, hours, days)
The unit of time associated with time_count, which defines the total interval of time relative to time_date for which data is returned. For example, if time_unit is hours, and time_count is +5, then data is returned for the five hour period beginning with and subsequent to time_date.
Example:
?time_unit=minutes&time_count=-5&time_date=now
- time_count: (integer)
Specifies the number of time_units for which data is returned, relative to time_date. A - preceding the time_count integer means the data is returned for time preceding time_date; a + preceding the time_count integer means the data is returned for time following time_date. For example, if time_count is -10 and time_unit is minutes, then data is returned for the ten minute period preceding (and thus ending with) time_date.
Example:
?time_date=now&time_count=-2&time_unit=days
- time_date: (string - pattern: ^(now|([0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}))$)
The point in time that defines the fixed endpoint for which data is returned. The values for time_count and time_unit define the total interval of time for which data is returned, relative to the time_date value. time_date can be specified by the string "now", or as a specific date date/time using the ISO 8601 format: YYYY-MM-DD[T]hh:mm. e.g. 2016-11-21T11:34 For example if time_date is "2017-01-30T12:00" then data is returned for the items which occurred prior to "2017-01-30T12:00". If time_date is not supplied as a query parameter, its value defaults to "now".
Example:
...&time_date=2015-08-15T14:34&...
- filter_name: (one of eventId, severity, process, server, type, instance)
The field being matched
Only the eventNumber, severity, process, server, type, instance, description fields are supported.
Example:
filter_name=process
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The match operation (operator)
Example:
filter_op=EQUAL
- filter_values: (string)
The matched value
The process value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=cmsoapa
- scope_type: (one of ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=NetworkElement&scope_name=DSR_dsrNetworkOam_9363ae5e
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=dsrNetworkOam_NOAM_9363ae5e_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/alarmhistoryCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/alarmhistory/alarmhistory.json",
"type" : "object",
"properties" : {
"server" : {
"type": "string",
"description": "Server on which the alarm was raised."
},
"timestamp" : {
"type": "string",
"description": "Timestamp of when the alarm was raised in an ISO 8601 format."
},
"severity" : {
"type": "string",
"description": "The severity of the alarm.",
"enum": [
"Clear",
"Critical",
"Info",
"Major",
"Minor"
]
},
"eventId" : {
"type": "integer",
"description": "A unique number assigned to each alarm in the system."
},
"eventText" : {
"type": "string",
"description": "Description about the alarm."
},
"type" : {
"type": "string",
"description": "Alarm or Event Type, for example, Process, Disk, Platform."
},
"process" : {
"type": "string",
"description": "Name of the process that generated the alarm."
},
"instance" : {
"type": "string",
"description": "Instance of the alarm, for example, Link01 or Disk02. The Instance provides additional information to help differentiate two or more alarms with the same number. This field may be blank if differentiation is not necessary."
},
"additionalInfo" : {
"type": "string",
"description": "Describes additional information about the Alarm."
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"additionalInfo": "GN_DOWN/WRN Replication of Config Tables is down [TopTransport.cxx:614][4413:PathAlarm.cxx:270]",
"eventId": 31114,
"eventText": "DB Replication over SOAP has failed",
"instance": "NOAM00-9363ae5e",
"process": "cmsoapa",
"server": "NOAM01-9363ae5e",
"severity": "Minor",
"timestamp": "2019-01-31T06:14:58.163254238-05:00",
"type": "REPL"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Mon: Alarms and Events Trap Log
The View Trap Log page allows you to monitor traps from external application equipment, such as switches and enclosures. The purpose of monitoring traps is to gain early warning of possible service impacting conditions. View Trap Log provides a visual indicator of active, existing conditions. It also provides a detailed log recording the historical conditions present in the external monitored hardware and important background information for investigating the root cause of the condition.
/mon/alarmseventstraplog
get /mon/alarmseventstraplog
Retrieves all alarm Trap Logs that meet the request parameters.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- time_unit: (one of minutes, hours, days)
The unit of time associated with time_count, which defines the total interval of time relative to time_date for which data is returned. For example, if time_unit is hours, and time_count is +5, then data is returned for the five hour period beginning with and subsequent to time_date.
Example:
?time_unit=minutes&time_count=-5&time_date=now
- time_count: (integer)
Specifies the number of time_units for which data is returned, relative to time_date. A - preceding the time_count integer means the data is returned for time preceding time_date; a + preceding the time_count integer means the data is returned for time following time_date. For example, if time_count is -10 and time_unit is minutes, then data is returned for the ten minute period preceding (and thus ending with) time_date.
Example:
?time_date=now&time_count=-2&time_unit=days
- time_date: (string - pattern: ^(now|([0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}))$)
The point in time that defines the fixed endpoint for which data is returned. The values for time_count and time_unit define the total interval of time for which data is returned, relative to the time_date value. time_date can be specified by the string "now", or as a specific date date/time using the ISO 8601 format: YYYY-MM-DD[T]hh:mm. e.g. 2016-11-21T11:34 For example if time_date is "2017-01-30T12:00" then data is returned for the items which occurred prior to "2017-01-30T12:00". If time_date is not supplied as a query parameter, its value defaults to "now".
Example:
...&time_date=2015-08-15T14:34&...
- filter_name: (one of trapCollector, OID, upTime, trapSource)
The field being matched
Only the trapCollector, OID, upTime, trapSource fields are supported.
Example:
filter_name=trapCollector
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE)
The match operation (operator)
Example:
filter_op=EQUAL
- filter_values: (string)
The matched value
The trapCollector value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=SOAM01-41eeab28
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/alarmtraplogCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/mon/alarmtraplog/alarmtraplog.json",
"properties": {
"trapId": {
"description": "Trap Identifier of Trap Logs.",
"type": "integer"
},
"trapLogs": {
"description": "List of Trap Logs for alarms and events.",
"items": {
"properties": {
"Oid": {
"description": "The Object Identifier (OID) for the trap.",
"type": "string"
},
"acked": {
"description": "A View Trap Log state can be either Acknowledge or Unacknowledge. Acknowledged traps are removed from both the trap count indicator and the View Trap Log list. When we Unacknowledge All, all previously acknowledged traps selected by the filter reappear in View Trap Log list.",
"enum": [
"Acknowledged",
"Unacknowledged"
],
"type": "string"
},
"trapType": {
"description": "Type of trap log.",
"enum": [
"UNK",
"DUP",
"NOTADUP"
],
"type": "string"
},
"timeStamp": {
"description": "The timestamp (in UTC) when the trap record was collected on the current system.",
"type": "array"
},
"trapCollector": {
"description": "The name of the server that first logged the trap.",
"type": "array"
},
"trapSource": {
"description": "The external hostname (or IP, if name cannot be resolved) for the trap source.",
"type": "array"
},
"upTime": {
"description": "The uptime as reported by the monitored external equipment.",
"type": "string"
},
"varBinds": {
"description": "The OID/value pairs found in the varbind list.",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"trapId": 35,
"trapLogs": [
{
"Oid": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.2.19800",
"acked": "Unacknowledged",
"timeStamp": [
"2019-02-07 15:25:59.565 EST",
"1663839363248271016"
],
"trapCollector": [
"DAMP00-41eeab28",
null,
"C1336.153"
],
"trapId": "35",
"trapSource": [
"localhost",
"127.0.0.1"
],
"trapType": "UNK",
"upTime": "1:13:10:50.19",
"varBinds": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.1.3.5.1.2.0.0.0.0.0.19800.0"
},
{
"Oid": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.2.10020",
"acked": "Unacknowledged",
"timeStamp": [
"2019-02-12 02:15:16.173 EST",
"1664252277790112984"
],
"trapCollector": [
"SOAM01-41eeab28",
null,
"B1336.018"
],
"trapId": "35",
"trapSource": [
"localhost",
"127.0.0.1"
],
"trapType": "UNK",
"upTime": "6:0:00:07.25",
"varBinds": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.1.3.5.1.2.0.0.0.0.0.10020.3.71.85.73"
}
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/alarmseventstraplog/{trapId}
get /mon/alarmseventstraplog/{trapId}
Retrieves a specific Alarms and Events Trap Log.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- trapId: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/alarmtraplogItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/mon/alarmtraplog/alarmtraplog.json",
"properties": {
"trapId": {
"description": "Trap Identifier of Trap Logs.",
"type": "integer"
},
"trapLogs": {
"description": "List of Trap Logs for alarms and events.",
"items": {
"properties": {
"Oid": {
"description": "The Object Identifier (OID) for the trap.",
"type": "string"
},
"acked": {
"description": "A View Trap Log state can be either Acknowledge or Unacknowledge. Acknowledged traps are removed from both the trap count indicator and the View Trap Log list. When we Unacknowledge All, all previously acknowledged traps selected by the filter reappear in View Trap Log list.",
"enum": [
"Acknowledged",
"Unacknowledged"
],
"type": "string"
},
"trapType": {
"description": "Type of trap log.",
"enum": [
"UNK",
"DUP",
"NOTADUP"
],
"type": "string"
},
"timeStamp": {
"description": "The timestamp (in UTC) when the trap record was collected on the current system.",
"type": "array"
},
"trapCollector": {
"description": "The name of the server that first logged the trap.",
"type": "array"
},
"trapSource": {
"description": "The external hostname (or IP, if name cannot be resolved) for the trap source.",
"type": "array"
},
"upTime": {
"description": "The uptime as reported by the monitored external equipment.",
"type": "string"
},
"varBinds": {
"description": "The OID/value pairs found in the varbind list.",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"trapId": 35,
"trapLogs": [
{
"Oid": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.2.19800",
"acked": "Unacknowledged",
"timeStamp": [
"2019-02-07 15:25:59.565 EST",
"1663839363248271016"
],
"trapCollector": [
"DAMP00-41eeab28",
null,
"C1336.153"
],
"trapId": "35",
"trapSource": [
"localhost",
"127.0.0.1"
],
"trapType": "UNK",
"upTime": "1:13:10:50.19",
"varBinds": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.1.3.5.1.2.0.0.0.0.0.19800.0"
},
{
"Oid": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.2.10020",
"acked": "Unacknowledged",
"timeStamp": [
"2019-02-12 02:15:16.173 EST",
"1664252277790112984"
],
"trapCollector": [
"SOAM01-41eeab28",
null,
"B1336.018"
],
"trapId": "35",
"trapSource": [
"localhost",
"127.0.0.1"
],
"trapType": "UNK",
"upTime": "6:0:00:07.25",
"varBinds": "TEKELEC-TOPLEVEL-REG::tekelecEAGLEXGDSR.1.1.3.5.1.2.0.0.0.0.0.10020.3.71.85.73"
}
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/mon/alarmseventstraplog/acknowledgeunacknowledge
put /mon/alarmseventstraplog/acknowledgeunacknowledge
It acknowledges and unacknowledges selected set of or All alarms and events trap logs.
Target server: NOAM or SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/mon/alarmacknowledge/alarmacknowledge.json",
"properties": {
"type": {
"description": "Acknowledge or Unacknowledge Trap Logs.",
"enum": [
"Acknowledged",
"Unacknowledged"
],
"type": "string"
},
"scope": {
"description": "Acknowledge or Unacknowledge some set of traps or all traps at a time.",
"enum": [
"All",
"Partial"
],
"type": "string"
}
},
"required": [
"type",
"scope"
],
"type": "object"
}
Example
{
"type":"Acknowledged",
"scope":{
"Partial":[
{
"trapCollector":"A1571.040",
"timeStamp":"1663788422858035808",
"trapId":"18"
},
{
"trapCollector":"B1336.018",
"timeStamp":"1663788421708472984",
"trapId":"23"
},
{
"trapCollector":"A1571.040",
"timeStamp":"1663695653364965856",
"trapId":"17"
}
]
}
}
Mon: KPI Data
Key Performance Indiciators (KPIs) are point-in-time indicators of system performance and health. KPI data is scoped to a server. When performing a GET request at the NOAM, A-Scoped KPIs for all servers in the topology are returned. Performing a GET request at the SOAM returns only the A and B-Scoped KPIs for the servers located at that site.
/mon/kpis/data
get /mon/kpis/data
Retrieveis all KPI data matching the provided query parameters.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
- ids: (string)
A comma-separated list of KPI IDs to include.
Example:
ids=31000,31001,31002
- group: (string)
The name of a KPI group to include in the returned results.
Example:
group=System
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/kpiCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/kpidata/kpi.json",
"type": "object",
"required": ["hostname","subgroups"],
"description": "The per-server KPI value(s)",
"properties" : {
"hostname" : {
"description": "The server producing this set of KPI values",
"type": "string",
"example": "ruby-noa"
},
"subgroups" : {
"type": "array",
"required": ["name","kpis"],
"description": "Scalar and Arrayed subgroups of KPI values",
"items": {
"type": "object",
"description": "A subgroups of KPI values",
"properties" : {
"name" : { "type": "string", "description": "The name of the KPIs subgroup" },
"kpis" : {
"description": "The values for each of the KPIs in the subgroup",
"type" : "array",
"items": {
"type": "object",
"description": "A per-host, per sub-group KPI value",
"properties" : {
"name": { "type": "string", "description": "The KPI Name" },
"value": { "type": "string", "description": "The KPI Value" },
"desc": { "type": "string", "description": "The KPI Description" }
}
},
"minItems": 1
}
}
},
"minItems": 0
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"hostname": "sapphire-noa",
"kpis": [
{
"name": "NonArrayed",
"items": [
{
"name": "CPU_UtilPct",
"value": "27.27 %",
"desc": "Percentage utilization of all processors on the server by all software as measured by the operating system."
},
{
"name": "RAM_UtilPct",
"value": "62.30 %",
"desc": "Percentage utilization of physical memory on the server by all software as measured by the operating system."
},
{
"name": "Swap_UtilPct",
"value": "0.00 %",
"desc": "Percentage utilization of swap space on the server by all software as measured by the operating system."
},
{
"name": "Disk_UtilPct",
"value": "6.29 %",
"desc": "Percentage utilization of disk space on the server by all software as measured by the operating system."
},
{
"name": "ShMem_UtilPct",
"value": "3.18 %",
"desc": "Percentage utilization of shared memory on the server by all software as measured by the operating system."
},
{
"name": "Uptime_Srv",
"value": "1.63 days",
"desc": "The total amount of time(days HH:MM:SS) the server has been running."
}
]
},
{
"name": "CPU_CoreUtilPct",
"items": [
{
"name": "0",
"value": "26.64 %",
"desc": "Percentage utilization of each processor core on the server as measured by the operating system."
},
{
"name": "1",
"value": "27.91 %",
"desc": "Percentage utilization of each processor core on the server as measured by the operating system."
}
]
}
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Mon: KPI Data Definitions
The KPI data dictionary is a catalog of available Key Performance Indicators (KPIs). It includes a description of each KPI. The identifier for a KPI data dictionary item can either be its numerical identifier (id) or its name.
/mon/kpis/defs
get /mon/kpis/defs
Returns the data dictionary definitions for all Key Performance Indicators (KPIs) that match the request parameters.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- group: (string)
The name of a KPI group to match.
Example:
group=System
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/kpidefCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/kpidef/kpidef.json",
"type": "object",
"required": ["id","name","description","scope","merged"],
"properties": {
"id": {
"description": "The KPI ID",
"type": "string",
"example":"31000",
"pattern" : "^[0-9]+$"
},
"name": {
"description": "The KPI name",
"type": "string",
"example": "System.CPU_UtilPct"
},
"description": {
"type": "string",
"description": "The KPI description",
"example": "Percentage utilization of all processors on the server by all software as measured by the operating system."
},
"scope": {
"type": "string",
"description": "The KPI scope",
"enum": [ "A", "B" ],
"example": "A"
},
"merged": {
"description": "true if the KPI is merged, false otherwise",
"type": "boolean",
"example": true
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"id": "31000",
"name": "System.CPU_UtilPct",
"description": "Percentage utilization of all processors on the server by all software as measured by the operating system.",
"merged": "Yes",
"scope": "A"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/kpis/defs/{idOrName}
get /mon/kpis/defs/{idOrName}
Returns the data dictionary definition for the specified Key Performance Indicator (KPI).
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- idOrName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/kpidefItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/kpidef/kpidef.json",
"type": "object",
"required": ["id","name","description","scope","merged"],
"properties": {
"id": {
"description": "The KPI ID",
"type": "string",
"example":"31000",
"pattern" : "^[0-9]+$"
},
"name": {
"description": "The KPI name",
"type": "string",
"example": "System.CPU_UtilPct"
},
"description": {
"type": "string",
"description": "The KPI description",
"example": "Percentage utilization of all processors on the server by all software as measured by the operating system."
},
"scope": {
"type": "string",
"description": "The KPI scope",
"enum": [ "A", "B" ],
"example": "A"
},
"merged": {
"description": "true if the KPI is merged, false otherwise",
"type": "boolean",
"example": true
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "31000",
"name": "System.CPU_UtilPct",
"description": "Percentage utilization of all processors on the server by all software as measured by the operating system.",
"merged": "Yes",
"scope": "A"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Mon: KPI Groups
A KPI group is a named collection of Key Performance Indicators (KPIs). This API provides a simple listing of the KPI group names, along with an indicator of whether each group is available at the NOAM, SOAM, or both. The KPI group name is the natural identifier for this collection.
/mon/kpis/groups
get /mon/kpis/groups
Returns a list of all defined KPI groups.
Target server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/kpigrpCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/kpigrp/kpigrp.json",
"type": "object",
"required": ["name","visibility"],
"properties": {
"name": {
"description": "The KPI group name",
"type": "string",
"example": "Server"
},
"visibility": {
"description": "The KPI group visibility",
"enum": [ "A", "B", "AB" ],
"type": "string",
"example": "AB"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "Server",
"visibility": "AB"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/kpis/groups/{group}
get /mon/kpis/groups/{group}
Returns the details for the specified KPI group.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- group: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/kpigrpItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/kpigrp/kpigrp.json",
"type": "object",
"required": ["name","visibility"],
"properties": {
"name": {
"description": "The KPI group name",
"type": "string",
"example": "Server"
},
"visibility": {
"description": "The KPI group visibility",
"enum": [ "A", "B", "AB" ],
"type": "string",
"example": "AB"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "Server",
"visibility": "AB"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Mon: KPI Scopes
Provides a list of valid Key Performance Indicator (KPI) group / scope combinations.
This can be used to:
- determine what scopes and KPI groups are valid.
- determine what scopes are valid for a named KPI group.
- determine what KPI groups are valid for a named scope.
- determine what nodes are valid for a named KPI group and scope.
/mon/kpis/scopes
get /mon/kpis/scopes
Expands the request into lists of valid KPI groups and scopes that match the request parameters.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
- group: (string)
The name of a KPI group to match.
Example:
group=System
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/kpiscopeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/kpiscope/kpiscope.json",
"type": "object",
"required": ["group","groups","scope","scopes"],
"properties": {
"group": {
"description": "The selected KPI group.",
"type": "string",
"example":"Server"
},
"groups": {
"description": "The valid KPI groups.",
"type": "array",
"items": {
"type": "string"
},
"minItems": 0
},
"scope": {
"description": "The selected KPI scope by scope type.",
"type": "object",
"additionalProperties" : {
"description": "A list scope names for this scope type.",
"type": "array",
"items": {
"type": "string"
},
"minItems": 0
}
},
"scopes": {
"description": "The available KPI scopes by scope type.",
"type": "object",
"additionalProperties" : {
"description": "A list of scope names for this scope type.",
"type": "array",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"group": "Server",
"groups": [
"ALEXA01",
"ALEXA03",
"ALEXA04",
"ALEXA05",
"ALEXA06",
"ALEXA07",
"ALEXA08",
"Server",
"ALEXA10"
],
"scope": {
"ServerGroup": [
"NO_SG"
]
},
"scopes": {
"NetworkElement": [
"NO_NE",
"SO_NE1"
],
"ServerGroup": [
"NO_SG",
"NO_SG2",
"SO1MP_SG1",
"SO_SG1"
]
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Mon: KPI Stats
Key Performance Indicators (KPIs) are point-in-time indicators of system performance and health. KPI stats provide a set of statistics for the selected scope. The KPI data from each of the servers in the selected scope is processed to create a set of overview statistics including max, min, median, average, and sum.
/mon/kpis/stats
get /mon/kpis/stats
Retrieves KPI statistics matching the request parameters.
Statistics provide max, min, median, average, and sum calculations across all the nodes in the selected scope. If the KPI is arrayed, then KPIs with the same array index will be used to calculate the statistics.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
- ids: (string)
A comma-seperated list of measurement IDs to include.
Example:
ids=31000,31001,31002
- group: (string)
The name of a measurement group to include.
Example:
group=System
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/kpistatCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/kpistat/kpistat.json",
"type": "object",
"required": ["name","stats"],
"description": "The set of KPI statistics for the selected scope.",
"properties" : {
"name" : {
"description": "The name for this statistic subgroup.",
"type": "string",
"example": "NonArrayed"
},
"stats" : {
"type": "array",
"description": "The set of KPI statistics for this subgroup.",
"items": {
"type": "object",
"required": ["name","max","min","average","median","sum","desc"],
"description": "The KPI statistics for individual subgroup items.",
"properties" : {
"name" : { "type": "string", "description": "The name of the KPI" },
"max" : { "type": "string", "description": "The max value across the selected scope" },
"min" : { "type": "string", "description": "The min value across the selected scope" },
"average" : { "type": "string", "description": "The average value across the selected scope" },
"median" : { "type": "string", "description": "The median value across the selected scope" },
"sum" : { "type": "string", "description": "The sum of the values across the selected scope" },
"desc" : { "type": "string", "description": "A short description of the KPI" }
}
},
"minItems": 0
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "NonArrayed",
"stats": [
{
"name": "System.CPU_UtilPct",
"max": "12.12 %",
"min": "10.64 %",
"sum": "65.74 %",
"median": "11.23 %",
"average": "10.96 %",
"desc": "Percentage utilization of all processors on the server by all software as measured by the operating system."
},
{
"name": "System.RAM_UtilPct",
"max": "58.59 %",
"min": "48.62 %",
"sum": "305.59 %",
"median": "49.59 %",
"average": "50.93 %",
"desc": "Percentage utilization of physical memory on the server by all software as measured by the operating system."
},
{
"name": "System.Swap_UtilPct",
"max": "0.00 %",
"min": "0.00 %",
"sum": "0.00 %",
"median": "0.00 %",
"average": "0.00 %",
"desc": "Percentage utilization of swap space on the server by all software as measured by the operating system."
},
{
"name": "System.Disk_UtilPct",
"max": "4.65 %",
"min": "4.59 %",
"sum": "27.69 %",
"median": "4.62 %",
"average": "4.62 %",
"desc": "Percentage utilization of disk space on the server by all software as measured by the operating system."
},
{
"name": "System.ShMem_UtilPct",
"max": "1.37 %",
"min": "1.29 %",
"sum": "8.03 %",
"median": "1.33 %",
"average": "1.34 %",
"desc": "Percentage utilization of shared memory on the server by all software as measured by the operating system."
},
{
"name": "System.Uptime_Srv",
"max": "1.01 hrs",
"min": "1.01 hrs",
"sum": "6.08 hrs",
"median": "1.01 hrs",
"average": "1.01 hrs",
"desc": "The total amount of time(days HH:MM:SS) the server has been running."
}
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Mon: Measurements Budget
Access to the measurements (/mon/measurements/data) interface is rate limited. Every request for measurements data has an associated cost and there is a budget that cannot be exceeded in any given time interval.
This measurements budget API provides access to the budget details for the measurement interface including:
- budget: the cost per interval that cannot be exceeded
- interval: the costing interval in minutes
- available: how much budget is left to be spent in the current interval
Costing intervals always begin on an even time boundary. For example, a 5 minute interval would begin on the hour, 5 minutes after the hour, 10 minutes after the hour, etc.
/mon/measurements/budget
get /mon/measurements/budget
Retrieves the measurement budget details.
Target server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/measbudgetItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/measbudget/measbudget.json",
"type": "object",
"required": ["budget","interval","available"],
"properties": {
"budget": {
"description": "The per interval budget.",
"type": "integer"
},
"interval": {
"description": "The budget interval in minutes.",
"type": "integer",
"example": 5,
"default": 5
},
"available": {
"description": "The amount of budget remaining.",
"type": "integer"
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"budget": 123412334,
"interval": "05:00",
"available": 123884
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Mon: Measurements Data
Measurements are collected on a wide variety of internal system behaviors. Measurements provide insight into processing rates and performance, and can be used to predict resource exhaustion.
Unlike most other collection GET operations, the /measurements collection requires that a query be provided to restrict the results to a specific set of measurement ids. If a time range is not specified, then only the most recently completed interval will be returned. If a scope is provided, then the measurements will be returned for all the servers identified by the named scope.
Measurements data returned from a /mon/measurements/data request is always Server-scoped. Clients wishing to retreive summary(rolled-up) measurement data must use the /mon/measurements/summary resource. Measurement data is scoped to a server. When performing a GET request at the NOAM, A-Scoped measurements for all servers in the topology are visible. Performing a GET request at the SOAM only returns A and B-Scoped measurements for the servers located at that site.
/mon/measurements/data
get /mon/measurements/data
Retrieve measurement data matching the supplied request parameters. Note that the /mon/measurements resource is rate limited. Every measurement retrieved has an associated cost, and every server processing the request has a cost budget. Requests that will exceed the budget are denied with an HTTP status code of 429. In this release of the DSR software, there are certain arrayed measurements for which a cost value is not currently calculated. For these arrayed measurements, the DSR reports a cost value of zero.
If no date parameters are provided in the request, only data for the last complete measurement collection interval is returned.
At least one measurement ID must be supplied in the request parameters.
Note that all times related to measurements are rounded back to fall on even 5 minute boundaries. For example, if the request asks for 8 minutes of measurement data ending at 10:43, the response will include 10 minutes of data ending at 10:40.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- time_unit: (one of minutes, hours, days)
The unit of time associated with time_count, which defines the total interval of time relative to time_date for which data is returned. For example, if time_unit is hours, and time_count is +5, then data is returned for the five hour period beginning with and subsequent to time_date.
Example:
?time_unit=minutes&time_count=-5&time_date=now
- time_count: (integer)
Specifies the number of time_units for which data is returned, relative to time_date. A - preceding the time_count integer means the data is returned for time preceding time_date; a + preceding the time_count integer means the data is returned for time following time_date. For example, if time_count is -10 and time_unit is minutes, then data is returned for the ten minute period preceding (and thus ending with) time_date.
Example:
?time_date=now&time_count=-2&time_unit=days
- time_date: (string - pattern: ^(now|([0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}))$)
The point in time that defines the fixed endpoint for which data is returned. The values for time_count and time_unit define the total interval of time for which data is returned, relative to the time_date value. time_date can be specified by the string "now", or as a specific date date/time using the ISO 8601 format: YYYY-MM-DD[T]hh:mm. e.g. 2016-11-21T11:34 For example if time_date is "2017-01-30T12:00" then data is returned for the items which occurred prior to "2017-01-30T12:00". If time_date is not supplied as a query parameter, its value defaults to "now".
Example:
...&time_date=2015-08-15T14:34&...
- scope_type: (one of ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
- ids: (string)
A comma-separated list of measurement IDs to include. Measurement IDs can be retrived from resource /mon/measurements/defs.
Example:
32011,32010
- interval: (one of 1Day, 12Hours, 1Hour, 30Min, 15Min, 5Min - default: 5Min)
Specifies the time interval between measurements returned by the OAM server, within the measurement report window defined by time_date/time_unit/time_count. For example, if the value for interval is 30Min, and the overall report window is 12 hours, then the response includes two data points per hour, for a total of 24 data points, for each measurement included in the response.
Example:
Hour
- pattern: (string)
The value for pattern is used to filter arrayed measurements which have indexes of string format, so the OAM server only return values for arrayed measurement instances that match the specified pattern with index of the measurement. The valid index value of an arrayed measurement is based on configuration and can be retrieved from resource /mon/measurements/summary.
Example:
Peer*
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/measurementItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/measdata/measurement.json",
"type": "object",
"properties": {
"cost": {
"description": "The measurement report generation cost (cell count)",
"example": 1032423,
"type": "integer"
},
"endTime": {
"description": "The measurement report end time. This time will be rounded to fit the measurement interval",
"example":"2016-09-01T07:58:48-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"interval": {
"default": "5Min",
"description": "The measurement reporting interval",
"enum": [ "5Min", "15Min", "30Min", "1Hour", "12Hours", "1Day" ],
"example": "5Min",
"type": "string"
},
"scopeName": {
"default": "All",
"description": "Scope name corresponding to the scopeType value",
"example": "NO_SG",
"type": "string"
},
"scopeType": {
"default": "Network",
"description": "A scope that bounds the returned measurement data",
"enum": [ "Network", "Server", "NetworkElement", "ServerGroup", "ResourceDomain", "Place", "PlaceAssociation" ],
"example": "ServerGroup",
"type": "string"
},
"servers":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/meascollection/meascollection.json",
"description": "A collection of measurements",
"type" : "array",
"items": {
"description": "Individual collections of measurements with similar indexes",
"properties": {
"hostname": {
"description": "The name of the server for the measurements",
"example": "NO1",
"type" : "string"
},
"metrics": {
"description": "Metrics set for the server",
"items": {
"description": "The measurement data for the server",
"properties": {
"collection": {
"description": "The name of the measurement collection, the expected values can be Single, Arrayed or the collection name if it exists",
"example": "Audits",
"type" : "string"
},
"names": {
"description": "An array of sets of name index, collection for a measurement",
"items": {
"properties": {
"index": {
"description": "The index value for the measurement. This value is applicable only for arrayed measurements",
"type" : "string"
},
"name": {
"description": "The index names for the measurement",
"type" : "string"
}
},
"type" :"object"
},
"type": "array"
} ,
"timestampValues":{
"description": "A set of timestamp and mapped measurement values",
"items": {
"description": "The timestamp value",
"properties": {
"timestamp": {
"example":"2016-09-01T07:38:48-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"values" :{
"description": "An array of measurement values",
"items": {
"type" :"string"
},
"type" :"array"
}
},
"type": "object"
},
"type": "array"
}
},
"type" :"object"
},
"type": "array"
}
},
"type" : "object"
}
},
"startTime": {
"description": "The measurement report start time. This time will be rounded to fit the measurement interval",
"example":"2016-09-01T07:38:48-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"cost": 133,
"endTime": "2016-09-01T07:38:48-04:00",
"interval": "15Min",
"scopeName": "All",
"scopeType": "Network",
"servers": [
{
"hostname": "SO1",
"metrics": [
{
"collection": "Single",
"names": [
{
"name": "Alarm.Crit"
},
{
"name": "Alarm.Major"
},
{
"name": "appworks.totalGuiReqAvg"
},
{
"name": "appworks.totalGuiReqCount"
},
{
"name": "appworks.totalGuiReqMax"
},
{
"name": "appworks.totalMmiReqAvg"
},
{
"name": "appworks.totalMmiReqCount"
},
{
"name": "appworks.totalMmiReqMax"
},
{
"name": "apwSoapServer.auditSkip"
},
{
"name": "apwSoapServer.cacheClear"
},
{
"name": "apwSoapServer.cacheHit"
},
{
"name": "apwSoapServer.cacheMiss"
},
{
"name": "apwSoapServer.procSig"
},
{
"name": "apwSoapServer.procStart"
},
{
"name": "apwSoapServer.soapClient"
},
{
"name": "apwSoapServer.soapReqAvg"
},
{
"name": "apwSoapServer.soapReqCount"
},
{
"name": "apwSoapServer.soapReqEnQ"
},
{
"name": "apwSoapServer.soapReqMax"
}
],
"timestampValues": [
{
"timestamp": "2016-09-01T06:30:48-04:00",
"values": [
"48",
"0",
"275.788136",
"236",
"4709",
"n/a",
"0",
"0",
"0",
"35",
"0",
"35",
"0",
"0",
"65",
"15.837294",
"547",
"547",
"186"
]
},
{
"timestamp": "2016-09-01T06:35:48-04:00",
"values": [
"49",
"0",
"357.913793",
"232",
"8641",
"2699.500000",
"2",
"3923",
"0",
"34",
"4",
"33",
"0",
"0",
"63",
"21.650255",
"589",
"589",
"224"
]
},
{
"timestamp": "2016-09-01T06:40:48-04:00",
"values": [
"45",
"0",
"389.060606",
"231",
"9096",
"3151.500000",
"4",
"6295",
"0",
"35",
"3",
"34",
"0",
"0",
"64",
"21.797251",
"582",
"582",
"264"
]
}
]
},
{
"collection": "CmSoap",
"names": [
{
"index": "getActiveVips",
"name": "apwSoapServer.cmSoapOutAvg"
},
{
"index": "getHaResourceStates",
"name": "apwSoapServer.cmSoapOutAvg"
},
{
"index": "getReplicationStatus",
"name": "apwSoapServer.cmSoapOutAvg"
},
{
"index": "getAddressPair",
"name": "apwSoapServer.cmSoapOutAvg"
},
{
"index": "getActiveVips",
"name": "apwSoapServer.cmSoapOutCount"
},
{
"index": "getHaResourceStates",
"name": "apwSoapServer.cmSoapOutCount"
},
{
"index": "getReplicationStatus",
"name": "apwSoapServer.cmSoapOutCount"
},
{
"index": "getAddressPair",
"name": "apwSoapServer.cmSoapOutCount"
},
{
"index": "getActiveVips",
"name": "apwSoapServer.cmSoapOutMax"
},
{
"index": "getHaResourceStates",
"name": "apwSoapServer.cmSoapOutMax"
},
{
"index": "getReplicationStatus",
"name": "apwSoapServer.cmSoapOutMax"
},
{
"index": "getAddressPair",
"name": "apwSoapServer.cmSoapOutMax"
}
],
"timestampValues": [
{
"timestamp": "2016-09-01T06:30:48-04:00",
"values": [
"34.466667",
"29.300000",
"30.100000",
"48.750000",
"15",
"20",
"10",
"20",
"135",
"97",
"51",
"282"
]
},
{
"timestamp": "2016-09-01T06:35:48-04:00",
"values": [
"36.562500",
"30.619048",
"35.700000",
"30.250000",
"16",
"21",
"10",
"20",
"121",
"93",
"69",
"60"
]
},
{
"timestamp": "2016-09-01T06:40:48-04:00",
"values": [
"38.250000",
"42.285714",
"21.400000",
"24.500000",
"16",
"21",
"10",
"20",
"129",
"131",
"26",
"37"
]
}
]
}
]
}
],
"startTime": "2016-09-01T06:20:48-04:00"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 429
request budget exceeded
Mon: Measurement Data Definitions
The measurement data dictionary is a catalog of available measurements. It includes a description of each measurement. The natural identifier for this collection is either the id or name field.
/mon/measurements/defs
get /mon/measurements/defs
Retrieves the measurement data dictionary items that match the request parameters.
Target server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/measdefCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/measdef/measdef.json",
"type": "object",
"properties": {
"id": {
"description": "The measurement ID",
"type": "string",
"example":"32000",
"pattern" : "^[0-9]+$"
},
"name": {
"description": "The measurement name",
"type": "string",
"example": "appworks.guiReqAvg"
},
"description": {
"description": "The measurement description",
"example": "Average AppWorks GUI request time",
"type": "string"
},
"collection": {
"description": "The indexed measurement name or 'Arrayed' for arrayed measurement and 'Single' for Simple type of measurement.",
"type": "string",
"example": "Single"
},
"maxCost": {
"description": "For a non-arrayed measurement, the maxCost value is 1. For arrayed measurements, the maxCost value is the sum of the costs associated with each indexed measurement within the array. The more indexed measurement values there are within an arrayed measurement, the higher the maxCost is for that arrayed measurement.",
"type": "integer",
"example": 30
},
"scope": {
"description": "The measurement scope",
"enum": [ "A", "B" ],
"example": "A"
},
"dim": {
"description": "The measurement dimension",
"enum": [ "Arrayed", "Single" ],
"example": "Arrayed"
},
"type": {
"description": "The measurement type",
"enum": [ "Average", "Simple", "Min", "Max" ],
"example": "Average"
},
"interval": {
"description": "The measurement collection interval",
"enum": [
"30Sec",
"1Min",
"5Min",
"15Min",
"30Min",
"1Hour",
"2Hours",
"4Hours"
],
"example": "5Min"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"id": "32000",
"name": "appworks.guiReqAvg",
"scope": "A",
"dim": "Arrayed",
"type": "Average",
"interval": "5Min",
"description": "Average AppWOrks GUI request time",
"collection": "Arrayed",
"maxCost": 356
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/measurements/defs/{idOrName}
get /mon/measurements/defs/{idOrName}
Retrives the measurement details for a specific measurement ID or name.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- idOrName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/measdefItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/measdef/measdef.json",
"type": "object",
"properties": {
"id": {
"description": "The measurement ID",
"type": "string",
"example":"32000",
"pattern" : "^[0-9]+$"
},
"name": {
"description": "The measurement name",
"type": "string",
"example": "appworks.guiReqAvg"
},
"description": {
"description": "The measurement description",
"example": "Average AppWorks GUI request time",
"type": "string"
},
"collection": {
"description": "The indexed measurement name or 'Arrayed' for arrayed measurement and 'Single' for Simple type of measurement.",
"type": "string",
"example": "Single"
},
"maxCost": {
"description": "For a non-arrayed measurement, the maxCost value is 1. For arrayed measurements, the maxCost value is the sum of the costs associated with each indexed measurement within the array. The more indexed measurement values there are within an arrayed measurement, the higher the maxCost is for that arrayed measurement.",
"type": "integer",
"example": 30
},
"scope": {
"description": "The measurement scope",
"enum": [ "A", "B" ],
"example": "A"
},
"dim": {
"description": "The measurement dimension",
"enum": [ "Arrayed", "Single" ],
"example": "Arrayed"
},
"type": {
"description": "The measurement type",
"enum": [ "Average", "Simple", "Min", "Max" ],
"example": "Average"
},
"interval": {
"description": "The measurement collection interval",
"enum": [
"30Sec",
"1Min",
"5Min",
"15Min",
"30Min",
"1Hour",
"2Hours",
"4Hours"
],
"example": "5Min"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "32000",
"name": "appworks.guiReqAvg",
"scope": "A",
"dim": "Arrayed",
"type": "Average",
"interval": "5Min",
"description": "Average AppWOrks GUI request time",
"collection": "Arrayed",
"maxCost": 356
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Mon: Measurement Groups
A measurement group is a named collection of measurements. This API provides a simple listing of the measurement group names, along with an indicator of whether each group is available at the NOAM, SOAM, or both. The measurement group name is the natural identifier for this collection.
/mon/measurements/groups
get /mon/measurements/groups
Returns a list of all defined measurement groups that match the request parameters.
Target server: NOAM or SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/measgrpCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/measgrp/measgrp.json",
"type": "object",
"properties": {
"name": {
"description": "The measurement group name.",
"type": "string",
"maxLength": 64,
"pattern": "^(([A-Za-z][ \\-A-Za-z0-9_]*)|([A-Za-z0-9_\\.]*[A-Za-z][A-Za-z0-9_]*))$",
"example": "OAM.PERF"
},
"maxCost": {
"description": "The maxCost for a measurement group is the sum of the maxCost values for all measurements that are included in the group.",
"type": "integer",
"example": 5
},
"visibility": {
"description": "The measurement group visibility.",
"enum": [ "A", "B", "AB" ],
"type": "string",
"example": "AB"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "OAM.PERF",
"visibility": "AB",
"maxCost": 45834
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/measurements/groups/{name}
get /mon/measurements/groups/{name}
Returns the details for the specified measurement group.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/measgrpItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/measgrp/measgrp.json",
"type": "object",
"properties": {
"name": {
"description": "The measurement group name.",
"type": "string",
"maxLength": 64,
"pattern": "^(([A-Za-z][ \\-A-Za-z0-9_]*)|([A-Za-z0-9_\\.]*[A-Za-z][A-Za-z0-9_]*))$",
"example": "OAM.PERF"
},
"maxCost": {
"description": "The maxCost for a measurement group is the sum of the maxCost values for all measurements that are included in the group.",
"type": "integer",
"example": 5
},
"visibility": {
"description": "The measurement group visibility.",
"enum": [ "A", "B", "AB" ],
"type": "string",
"example": "AB"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "OAM.PERF",
"visibility": "AB",
"maxCost": 45834
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Mon: Measurements Summary
Measurements are collected on a wide variety of internal system behaviors. Measurements provide insight into processing rates and performance, and can be used to predict resource exhaustion.
Unlike most other collection GET operations, the /measurements collection requires that a query be provided to restrict the results to a specific set of measurement ids. If a time range is not specified, then only the most recently completed interval will be returned. If a scope is provided, then the measurements will be returned for all the servers identified by the named scope.
Measurement data returned from /mon/measurements/summary is a summary ("rollup") - a single aggregated data set across the servers in the requested scope.
/mon/measurements/summary
get /mon/measurements/summary
Retrieve measurement data matching the supplied request parameters. Note that the /mon/measurements resource is rate limited. Every measurement retrieved has an associated cost, and every server processing the request has a cost budget. Requests that will exceed the budget are denied with an HTTP status code of 429. In this release of the DSR software, there are certain arrayed measurements for which a cost value is not currently calculated. For these arrayed measurements, the DSR reports a cost value of zero.
If no date parameters are provided in the request, only data for the last complete measurement collection interval is returned.
At least one measurement ID must be supplied in the request parameters.
Note that all times related to measurements are rounded back to fall on even 5 minute boundaries. For example, if the request asks for 8 minutes of measurement data ending at 10:43, the response will include 10 minutes of data ending at 10:40.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- time_unit: (one of minutes, hours, days)
The unit of time associated with time_count, which defines the total interval of time relative to time_date for which data is returned. For example, if time_unit is hours, and time_count is +5, then data is returned for the five hour period beginning with and subsequent to time_date.
Example:
?time_unit=minutes&time_count=-5&time_date=now
- time_count: (integer)
Specifies the number of time_units for which data is returned, relative to time_date. A - preceding the time_count integer means the data is returned for time preceding time_date; a + preceding the time_count integer means the data is returned for time following time_date. For example, if time_count is -10 and time_unit is minutes, then data is returned for the ten minute period preceding (and thus ending with) time_date.
Example:
?time_date=now&time_count=-2&time_unit=days
- time_date: (string - pattern: ^(now|([0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}))$)
The point in time that defines the fixed endpoint for which data is returned. The values for time_count and time_unit define the total interval of time for which data is returned, relative to the time_date value. time_date can be specified by the string "now", or as a specific date date/time using the ISO 8601 format: YYYY-MM-DD[T]hh:mm. e.g. 2016-11-21T11:34 For example if time_date is "2017-01-30T12:00" then data is returned for the items which occurred prior to "2017-01-30T12:00". If time_date is not supplied as a query parameter, its value defaults to "now".
Example:
...&time_date=2015-08-15T14:34&...
- scope_type: (one of ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
- ids: (string)
A comma-separated list of measurement IDs to include. Measurement IDs can be retrived from resource /mon/measurements/defs.
Example:
32011,32010
- interval: (one of 1Day, 12Hours, 1Hour, 30Min, 15Min, 5Min - default: 5Min)
Specifies the time interval between measurements returned by the OAM server, within the measurement report window defined by time_date/time_unit/time_count. For example, if the value for interval is 30Min, and the overall report window is 12 hours, then the response includes two data points per hour, for a total of 24 data points, for each measurement included in the response.
Example:
Hour
- pattern: (string)
The value for pattern is used to filter arrayed measurements which have indexes of string format, so the OAM server only return values for arrayed measurement instances that match the specified pattern with index of the measurement. The valid index value of an arrayed measurement is based on configuration and can be retrieved from resource /mon/measurements/summary.
Example:
Peer*
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/meassummaryItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/meassummary/meassummary.json",
"type": "object",
"properties": {
"cost": {
"description": "The measurement report generation cost (cell count)",
"example": 1032423,
"type": "integer"
},
"endTime": {
"description": "The measurement report end time. This time will be rounded to fit the measurement interval",
"example":"2016-09-01T07:58:48-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"interval": {
"default": "5Min",
"description": "The measurement reporting interval",
"enum": [ "5Min", "15Min", "30Min", "1Hour", "12Hours", "1Day" ],
"example": "5Min",
"type": "string"
},
"scopeName": {
"default": "All",
"description": "Scope name corresponding to the scopeType value",
"example": "NO_SG",
"type": "string"
},
"scopeType": {
"default": "Network",
"description": "A scope that bounds the returned measurement data",
"enum": [ "Network", "Server", "NetworkElement", "ServerGroup", "ResourceDomain", "Place", "PlaceAssociation" ],
"example": "ServerGroup",
"type": "string"
},
"startTime": {
"description": "The measurement report start time. This time will be rounded to fit the measurement interval",
"example":"2016-09-01T07:38:48-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"summary":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/meascollection/meascollection.json",
"description": "A collection of measurements",
"type" : "array",
"items": {
"description": "Individual collections of measurements with similar indexes",
"properties": {
"hostname": {
"description": "The name of the server for the measurements",
"example": "NO1",
"type" : "string"
},
"metrics": {
"description": "Metrics set for the server",
"items": {
"description": "The measurement data for the server",
"properties": {
"collection": {
"description": "The name of the measurement collection, the expected values can be Single, Arrayed or the collection name if it exists",
"example": "Audits",
"type" : "string"
},
"names": {
"description": "An array of sets of name index, collection for a measurement",
"items": {
"properties": {
"index": {
"description": "The index value for the measurement. This value is applicable only for arrayed measurements",
"type" : "string"
},
"name": {
"description": "The index names for the measurement",
"type" : "string"
}
},
"type" :"object"
},
"type": "array"
} ,
"timestampValues":{
"description": "A set of timestamp and mapped measurement values",
"items": {
"description": "The timestamp value",
"properties": {
"timestamp": {
"example":"2016-09-01T07:38:48-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"values" :{
"description": "An array of measurement values",
"items": {
"type" :"string"
},
"type" :"array"
}
},
"type": "object"
},
"type": "array"
}
},
"type" :"object"
},
"type": "array"
}
},
"type" : "object"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"cost": 36,
"endTime": "2016-09-01T07:38:48-04:00",
"interval": "15Min",
"scopeName": "All",
"scopeType": "Network",
"startTime": "2016-09-01T05:38:48-04:00",
"summary": [
{
"hostname": "ALL",
"metrics": [
{
"collection": "Single",
"names": [
{
"name": "Alarm.Crit"
},
{
"name": "Alarm.Major"
},
{
"name": "System.CPU_UtilPct_Average"
},
{
"name": "System.CPU_UtilPct_Peak"
},
{
"name": "System.Disk_UtilPct_Average"
},
{
"name": "System.Disk_UtilPct_Peak"
},
{
"name": "System.RAM_UtilPct_Average"
},
{
"name": "System.RAM_UtilPct_Peak"
},
{
"name": "System.ShMem_UtilPct_Average"
},
{
"name": "System.ShMem_UtilPct_Peak"
},
{
"name": "System.SwapIn_Rate_Average"
},
{
"name": "System.SwapIn_Rate_Peak"
},
{
"name": "System.SwapOut_Rate_Average"
},
{
"name": "System.SwapOut_Rate_Peak"
},
{
"name": "System.Swap_UtilPct_Average"
},
{
"name": "System.Swap_UtilPct_Peak"
}
],
"timestampValues": [
{
"timestamp": "2016-09-01T06:38:48-04:00",
"values": [
"161",
"0",
"45.077033",
"100",
"1.340956",
"2",
"25.953233",
"27",
"0.408722",
"1",
"0.000000",
"0",
"0.000000",
"0",
"0.000000",
"0"
]
}
]
},
{
"collection": "Arrayed",
"names": [
{
"index": "0",
"name": "System.CPU_CoreUtilPct_Average"
},
{
"index": "0",
"name": "System.CPU_CoreUtilPct_Peak"
}
],
"timestampValues": [
{
"timestamp": "2016-09-01T06:38:48-04:00",
"values": [
"45.077033",
"100"
]
}
]
}
]
}
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 429
request budget exceeded
Mon: Tasks
Tasks are used to perform longer running or periodically scheduled activities. This API allows the status of all running and recently run tasks to be examined. The id field provides the unique identifier for each task.
/mon/tasks
get /mon/tasks
Retrieves the task details for all tasks that match the GET request criteria. The request must supply a query parameter specifying a scope.
Target server: NOAM or SOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/collections/taskCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/task/task.json",
"type" :"object",
"required": [
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Task identifier"
},
"hostname": {
"type": "string",
"description": "Server running task"
},
"name": {
"type": "string",
"description": "Task Name"
},
"status": {
"type": "string",
"description": "Admin Status",
"enum": [ "Running", "Stopped", "Paused", "Completed", "Exception" ]
},
"startTime": {
"description": "The task start time",
"type": "string",
"example":"2015-08-12T14:46:13-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"updateTime": {
"description": "The task status last update time",
"type": "string",
"example":"2015-08-12T14:47:43-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"progress": {
"description": "The task progress",
"type": "integer",
"example":"100",
"minimum" : 0,
"maximum" : 100
},
"details": {
"description": "Task Details",
"type": "string",
"example": "Lots of interesting details..."
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"id": "ruby-noa:0",
"server": "ruby-noa",
"name": "joe",
"status": "completed",
"startTime": "2015-09-28T13:33:05-04:00",
"updateTime": "2015-09-28T13:34:11-04:00",
"progress": 100,
"details": "Lots of task details..."
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/tasks/{id}
get /mon/tasks/{id}
Returns the details for the specified task.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/mon/items/taskItem.json",
"type": "object",
"properties": {
"data":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/task/task.json",
"type" :"object",
"required": [
"name"
],
"properties": {
"id": {
"type": "string",
"description": "Task identifier"
},
"hostname": {
"type": "string",
"description": "Server running task"
},
"name": {
"type": "string",
"description": "Task Name"
},
"status": {
"type": "string",
"description": "Admin Status",
"enum": [ "Running", "Stopped", "Paused", "Completed", "Exception" ]
},
"startTime": {
"description": "The task start time",
"type": "string",
"example":"2015-08-12T14:46:13-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"updateTime": {
"description": "The task status last update time",
"type": "string",
"example":"2015-08-12T14:47:43-04:00",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$"
},
"progress": {
"description": "The task progress",
"type": "integer",
"example":"100",
"minimum" : 0,
"maximum" : 100
},
"details": {
"description": "Task Details",
"type": "string",
"example": "Lots of interesting details..."
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"id": "ruby-noa:0",
"server": "ruby-noa",
"name": "joe",
"status": "completed",
"startTime": "2015-09-28T13:33:05-04:00",
"updateTime": "2015-09-28T13:34:11-04:00",
"progress": 100,
"details": "Lots of task details..."
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/mon/tasks/{id}/status
get /mon/tasks/{id}/status
Returns the current state of a running task, which can be Running, Paused, or Stopped.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema",
"id" : "http://dsr.cgbu.oracle.com/schemas/mon/task/taskstatus.json",
"type": "object",
"required": ["taskState"],
"properties": {
"taskState": {
"description": "Task State",
"enum": [ "Running", "Paused", "Stopped" ],
"example": "Running"
}
}
}
Example
{
"taskState": "Stopped"
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Radius: Ingress Status Server Configuration Sets
An Ingress Status Server Configuration Set is an identification for telling about configuration related to Ingress Status Server Configuration Set.
All Ingress Status Server Configuration Set configuration is done at the SOAM.
/radius/ingressstatusserverconfigurationsets
get /radius/ingressstatusserverconfigurationsets
Returns all Ingress Status Server Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/collections/ingressstatusserverconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/ingressstatusserverconfigurationset/ingressstatusserverconfigurationset.json",
"properties": {
"ingressStatusServerSetName": {
"description": "Name for the Ingress Status Server Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Ingress Status Server Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerResponseMessageType": {
"description": "Identify Status-Server Response message type. Default value is Accounting-Response ",
"enum": [
"AccountingResponse",
"AccessAccept"
],
"type": "string"
},
"sendResponseToStatusServer": {
"description": "This specify whether DSR should silently discard incoming Status-Server message. Default is true. Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"ingressStatusServerSetName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"ingressStatusServerSetName": "IngressServer1",
"statusServerResponseMessageType": "AccessAccept",
"sendResponseToStatusServer": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
post /radius/ingressstatusserverconfigurationsets
Adds a new Ingress Status Server Configuration Set to the DSR configuration. The new Ingress Status Server Configuration Set must be unique.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/ingressstatusserverconfigurationset/ingressstatusserverconfigurationset.json",
"properties": {
"ingressStatusServerSetName": {
"description": "Name for the Ingress Status Server Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Ingress Status Server Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerResponseMessageType": {
"description": "Identify Status-Server Response message type. Default value is Accounting-Response ",
"enum": [
"AccountingResponse",
"AccessAccept"
],
"type": "string"
},
"sendResponseToStatusServer": {
"description": "This specify whether DSR should silently discard incoming Status-Server message. Default is true. Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"ingressStatusServerSetName"
],
"type": "object"
}
Example
{
"ingressStatusServerSetName": "IngressServer1",
"statusServerResponseMessageType": "AccessAccept",
"sendResponseToStatusServer": true
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/radius/ingressstatusserverconfigurationsets/{ingressStatusServerSetName}
get /radius/ingressstatusserverconfigurationsets/{ingressStatusServerSetName}
Returns the configuration details for the specified Ingress Status Server Configuration Set. If the specified Ingress Status Server Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- ingressStatusServerSetName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/items/ingressstatusserverconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/ingressstatusserverconfigurationset/ingressstatusserverconfigurationset.json",
"properties": {
"ingressStatusServerSetName": {
"description": "Name for the Ingress Status Server Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Ingress Status Server Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerResponseMessageType": {
"description": "Identify Status-Server Response message type. Default value is Accounting-Response ",
"enum": [
"AccountingResponse",
"AccessAccept"
],
"type": "string"
},
"sendResponseToStatusServer": {
"description": "This specify whether DSR should silently discard incoming Status-Server message. Default is true. Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"ingressStatusServerSetName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ingressStatusServerSetName": "IngressServer1",
"statusServerResponseMessageType": "AccessAccept",
"sendResponseToStatusServer": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /radius/ingressstatusserverconfigurationsets/{ingressStatusServerSetName}
Updates the associated Ingress Status Server Configuration Set Name.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- ingressStatusServerSetName: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/ingressstatusserverconfigurationset/ingressstatusserverconfigurationset.json",
"properties": {
"ingressStatusServerSetName": {
"description": "Name for the Ingress Status Server Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Ingress Status Server Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"statusServerResponseMessageType": {
"description": "Identify Status-Server Response message type. Default value is Accounting-Response ",
"enum": [
"AccountingResponse",
"AccessAccept"
],
"type": "string"
},
"sendResponseToStatusServer": {
"description": "This specify whether DSR should silently discard incoming Status-Server message. Default is true. Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"ingressStatusServerSetName"
],
"type": "object"
}
Example
{
"ingressStatusServerSetName": "IngressServer1",
"statusServerResponseMessageType": "AccessAccept",
"sendResponseToStatusServer": true
}
delete /radius/ingressstatusserverconfigurationsets/{ingressStatusServerSetName}
Deletes the specified Ingress Status Server Configuration Set from the SOAM configuration. An Ingress Status Server Configuration Set can only be deleted if all delete validation checks pass. In general, if the Ingress Status Server Configuration Set is part of the configuration of some other Managed Object, the Ingress Status Server Configuration Set cannot be deleted. An attempt to delete an Ingress Status Server Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- ingressStatusServerSetName: required (string)
Radius: Message Authenticator Configuration Sets
A Message Authenticator Configuration Set is an identification for telling about configuration related to Message Authenticator Configuration Set.
All Message Authenticator Configuration Set configuration is done at the SOAM.
/radius/messageauthenticatorconfigurationsets
get /radius/messageauthenticatorconfigurationsets
Returns all Message Authenticator Configuration Sets configured at the SOAM that meet the criteria specified in a valid GET request.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/collections/messageauthenticatorconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/messageauthenticatorconfigurationset/messageauthenticatorconfigurationset.json",
"properties": {
"messageAuthenticatorConfigurationSetName": {
"description": "Name for the Message Authenticator Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Message Authenticator Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"clientEncodeMessageAuthenticatorInEgressAccessRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Request message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is the value configured in Default Message Authenticator Configuration Set . Ranges to true and false. ",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressCoARequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessAccept": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Accept message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Challenge message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessReject": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Reject message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoAACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoANACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressStatusServer": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to the Accounting-Response or Access-Accept message that is sent in response to a Status-Server request. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"messageAuthenticatorConfigurationSetName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"clientEncodeMessageAuthenticatorInEgressAccessRequest": false,
"clientEncodeMessageAuthenticatorInEgressCoARequest": true,
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": false,
"messageAuthenticatorConfigurationSetName": "test",
"serverEncodeMessageAuthenticatorInEgressAccessAccept": false,
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": true,
"serverEncodeMessageAuthenticatorInEgressAccessReject": false,
"serverEncodeMessageAuthenticatorInEgressCoAACK": false,
"serverEncodeMessageAuthenticatorInEgressCoANACK": true,
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": false,
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": false,
"serverEncodeMessageAuthenticatorInEgressStatusServer": false
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
post /radius/messageauthenticatorconfigurationsets
Adds a new Message Authenticator Configuration Set to the DSR configuration. The new Message Authenticator Configuration Set must be unique.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/messageauthenticatorconfigurationset/messageauthenticatorconfigurationset.json",
"properties": {
"messageAuthenticatorConfigurationSetName": {
"description": "Name for the Message Authenticator Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Message Authenticator Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"clientEncodeMessageAuthenticatorInEgressAccessRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Request message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is the value configured in Default Message Authenticator Configuration Set . Ranges to true and false. ",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressCoARequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessAccept": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Accept message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Challenge message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessReject": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Reject message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoAACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoANACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressStatusServer": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to the Accounting-Response or Access-Accept message that is sent in response to a Status-Server request. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"messageAuthenticatorConfigurationSetName"
],
"type": "object"
}
Example
{
"clientEncodeMessageAuthenticatorInEgressAccessRequest": false,
"clientEncodeMessageAuthenticatorInEgressCoARequest": true,
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": false,
"messageAuthenticatorConfigurationSetName": "test",
"serverEncodeMessageAuthenticatorInEgressAccessAccept": false,
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": true,
"serverEncodeMessageAuthenticatorInEgressAccessReject": false,
"serverEncodeMessageAuthenticatorInEgressCoAACK": false,
"serverEncodeMessageAuthenticatorInEgressCoANACK": true,
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": false,
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": false,
"serverEncodeMessageAuthenticatorInEgressStatusServer": false
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/radius/messageauthenticatorconfigurationsets/{messageauthenticatorconfigurationSetName}
get /radius/messageauthenticatorconfigurationsets/{messageauthenticatorconfigurationSetName}
Returns the configuration details for the specified Message Authenticator Configuration Set. If the specified Message Authenticator Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- messageauthenticatorconfigurationSetName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/items/messageauthenticatorconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/messageauthenticatorconfigurationset/messageauthenticatorconfigurationset.json",
"properties": {
"messageAuthenticatorConfigurationSetName": {
"description": "Name for the Message Authenticator Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Message Authenticator Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"clientEncodeMessageAuthenticatorInEgressAccessRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Request message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is the value configured in Default Message Authenticator Configuration Set . Ranges to true and false. ",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressCoARequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessAccept": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Accept message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Challenge message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessReject": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Reject message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoAACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoANACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressStatusServer": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to the Accounting-Response or Access-Accept message that is sent in response to a Status-Server request. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"messageAuthenticatorConfigurationSetName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"clientEncodeMessageAuthenticatorInEgressAccessRequest": false,
"clientEncodeMessageAuthenticatorInEgressCoARequest": true,
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": false,
"messageAuthenticatorConfigurationSetName": "test",
"serverEncodeMessageAuthenticatorInEgressAccessAccept": false,
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": true,
"serverEncodeMessageAuthenticatorInEgressAccessReject": false,
"serverEncodeMessageAuthenticatorInEgressCoAACK": false,
"serverEncodeMessageAuthenticatorInEgressCoANACK": true,
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": false,
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": false,
"serverEncodeMessageAuthenticatorInEgressStatusServer": false
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /radius/messageauthenticatorconfigurationsets/{messageauthenticatorconfigurationSetName}
Updates the associated Message Authenticator Configuration Set Name.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- messageauthenticatorconfigurationSetName: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/messageauthenticatorconfigurationset/messageauthenticatorconfigurationset.json",
"properties": {
"messageAuthenticatorConfigurationSetName": {
"description": "Name for the Message Authenticator Configuration Set, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all Message Authenticator Configuration Sets.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"clientEncodeMessageAuthenticatorInEgressAccessRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Request message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is the value configured in Default Message Authenticator Configuration Set . Ranges to true and false. ",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressCoARequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-Request message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessAccept": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Accept message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Challenge message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressAccessReject": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Access-Reject message prior to forwarding the message to the RADIUS connection. If the message contains an EAP-Message attribute, a Message-Authenticator will be added and this attribute will be ignored by DSR. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoAACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressCoANACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS CoA-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-ACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to a RADIUS Disconnect-NACK message prior to forwarding the message to the RADIUS connection. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
},
"serverEncodeMessageAuthenticatorInEgressStatusServer": {
"description": "Specifies whether DSR should add a Message-Authenticator attribute to the Accounting-Response or Access-Accept message that is sent in response to a Status-Server request. Default value is configured in Default Message Authenticator Configuration Set . Ranges to true and false.",
"type": "boolean"
}
},
"required": [
"messageAuthenticatorConfigurationSetName"
],
"type": "object"
}
Example
{
"clientEncodeMessageAuthenticatorInEgressAccessRequest": false,
"clientEncodeMessageAuthenticatorInEgressCoARequest": true,
"clientEncodeMessageAuthenticatorInEgressDisconnectRequest": false,
"messageAuthenticatorConfigurationSetName": "test",
"serverEncodeMessageAuthenticatorInEgressAccessAccept": false,
"serverEncodeMessageAuthenticatorInEgressAccessChallenge": true,
"serverEncodeMessageAuthenticatorInEgressAccessReject": false,
"serverEncodeMessageAuthenticatorInEgressCoAACK": false,
"serverEncodeMessageAuthenticatorInEgressCoANACK": true,
"serverEncodeMessageAuthenticatorInEgressDisconnectACK": false,
"serverEncodeMessageAuthenticatorInEgressDisconnectNACK": false,
"serverEncodeMessageAuthenticatorInEgressStatusServer": false
}
delete /radius/messageauthenticatorconfigurationsets/{messageauthenticatorconfigurationSetName}
Deletes the specified Message Authenticator Configuration Set from the SOAM configuration. An Message Authenticator Configuration Set can only be deleted if all delete validation checks pass. In general, if the Message Authenticator Configuration Set is part of the configuration of some other Managed Object, the Message Authenticator Configuration Set cannot be deleted. An attempt to delete an Message Authenticator Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- messageauthenticatorconfigurationSetName: required (string)
Radius: Message Conversion Configuration Sets
Message Conversion Configuration Sets is a collection of message conversion set rules for conversion sets.
/radius/messageconversionconfigurationsets
get /radius/messageconversionconfigurationsets
Returns the set of current values for the Message Conversion Configuration Sets.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/items/messageconversionconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/messageconversionconfigurationset/messageconversionconfigurationset.json",
"properties": {
"msgConvCfgSetName": {
"description": "An unique name for message conversion data set.",
"readOnly": true,
"type": "string"
},
"msgConvCfgSetRules": {
"description": "It describe set of rules for each message conversion sonfiguration set.",
"items": {
"properties": {
"applId": {
"description": "The 32-bit Diameter message Application ID.",
"readOnly": true,
"type": "string"
},
"applName": {
"description": "The Diameter message Application name wrt Application ID.",
"readOnly": true,
"type": "string"
},
"cmdCodes": {
"description": "The 24-bit Diameter message Command Code.",
"readOnly": true,
"type": "string"
},
"convType": {
"description": "Specifies the type of conversion that this rule applies.",
"readOnly": true,
"type": "string"
},
"radiusCode": {
"description": "The 8-bit RADIUS message code header.",
"readOnly": true,
"type": "string"
}
},
"required": [
"applId",
"cmdCodes",
"convType",
"radiusCode"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"msgConvCfgSetName",
"msgConvCfgSetRules"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"msgConvCfgSetName": "Default",
"msgConvCfgSetRules": [
{
"applId": "3",
"applName": "Diameter base accounting",
"cmdCodes": "CCR/CCA",
"convType": "R to D",
"radiusCode": "Accounting-Request"
},
{
"applId": "3",
"applName": "Diameter base accounting",
"cmdCodes": "ASR/ASA",
"convType": "R to D",
"radiusCode": "Disconnect-Request"
},
{
"applId": "3",
"applName": "Diameter base accounting",
"cmdCodes": "RAR/RAA",
"convType": "R to D",
"radiusCode": "CoA-Request"
},
{
"applId": "16777250",
"applName": "3GPP Sta",
"cmdCodes": "DER/DEA",
"convType": "R to D",
"radiusCode": "Access-Request"
}
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
Radius: NAS Nodes
A NAS Nodes is an identification for telling about configuration related to NAS Node.
All NAS Nodes configuration is done at the SOAM.
/radius/nasnodes
get /radius/nasnodes
Returns all NAS Nodes configured at the SOAM that meet the criteria specified in a valid GET request.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/collections/nasnodeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/nasnode/nasnode.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this NAS Node. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"nasIdentifier": {
"description": "A unique string to identify the NAS originating the Requests. NAS-Identifier attribute is simply a string that contains alphanumeric characters and the following special characters described in pattern. Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"nasIPAddresses": {
"description": "This specify the IP address list of this NAS Node. Maximum 2 IPv4 and maximum 2 IPv6 addresses are supported.Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"nasNodeName": {
"description": "Name for the NAS Node, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all NAS Nodes.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this NAS Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination. While inserting new record following thing should be considered: Firstly,Realm and NAS-Identifier combination shall be unique across the NAS Nodes. Secondly, Realm and IP address combination shall be unique across the NAS Nodes.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"fqdn",
"nasNodeName",
"realm"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"fqdn": "fqdn.com",
"nasIPAddresses": [
"10.75.225.70",
"::125"
],
"nasIdentifier": "try",
"nasNodeName": "nasnode1",
"realm": "oracle.com"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
post /radius/nasnodes
Adds a new NAS Node to the DSR configuration. The new NAS Node must be unique. Following things should be taken in to consideration:firstly,Realm and NAS-Identifier combination shall be unique across the NAS Nodes. Secondly, Realm and IP address combination shall be unique across the NAS Nodes.Thirdly,either or both of NAS Identifier or NAS IP Address should be present. Fourthly, when inserting a new NAS Node instance, the Realm and FQDN combinations shall be unique.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/nasnode/nasnode.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this NAS Node. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"nasIdentifier": {
"description": "A unique string to identify the NAS originating the Requests. NAS-Identifier attribute is simply a string that contains alphanumeric characters and the following special characters described in pattern. Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"nasIPAddresses": {
"description": "This specify the IP address list of this NAS Node. Maximum 2 IPv4 and maximum 2 IPv6 addresses are supported.Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"nasNodeName": {
"description": "Name for the NAS Node, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all NAS Nodes.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this NAS Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination. While inserting new record following thing should be considered: Firstly,Realm and NAS-Identifier combination shall be unique across the NAS Nodes. Secondly, Realm and IP address combination shall be unique across the NAS Nodes.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"fqdn",
"nasNodeName",
"realm"
],
"type": "object"
}
Example
{
"fqdn": "fqdn.com",
"nasIPAddresses": [
"10.75.225.70",
"::125"
],
"nasIdentifier": "try",
"nasNodeName": "nasnode1",
"realm": "oracle.com"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/radius/nasnodes/{nasNodeName}
get /radius/nasnodes/{nasNodeName}
Returns the configuration details for the specified NAS Node. If the specified NAS Node does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- nasNodeName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/items/nasnodeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/nasnode/nasnode.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this NAS Node. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"nasIdentifier": {
"description": "A unique string to identify the NAS originating the Requests. NAS-Identifier attribute is simply a string that contains alphanumeric characters and the following special characters described in pattern. Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"nasIPAddresses": {
"description": "This specify the IP address list of this NAS Node. Maximum 2 IPv4 and maximum 2 IPv6 addresses are supported.Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"nasNodeName": {
"description": "Name for the NAS Node, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all NAS Nodes.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this NAS Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination. While inserting new record following thing should be considered: Firstly,Realm and NAS-Identifier combination shall be unique across the NAS Nodes. Secondly, Realm and IP address combination shall be unique across the NAS Nodes.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"fqdn",
"nasNodeName",
"realm"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"fqdn": "fqdn.com",
"nasIPAddresses": [
"10.75.225.70",
"::125"
],
"nasIdentifier": "try",
"nasNodeName": "nasnode1",
"realm": "oracle.com"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /radius/nasnodes/{nasNodeName}
Updates the associated NAS Node.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- nasNodeName: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/nasnode/nasnode.json",
"properties": {
"fqdn": {
"description": "Fully Qualified Domain Name of this NAS Node. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"nasIdentifier": {
"description": "A unique string to identify the NAS originating the Requests. NAS-Identifier attribute is simply a string that contains alphanumeric characters and the following special characters described in pattern. Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"nasIPAddresses": {
"description": "This specify the IP address list of this NAS Node. Maximum 2 IPv4 and maximum 2 IPv6 addresses are supported.Though this is non mandatory parameter but either NAS Node Identifer or NAS Node IP Addresses is required",
"items": {
"type": "string"
},
"maxItems": 4,
"minItems": 0,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "array"
},
"nasNodeName": {
"description": "Name for the NAS Node, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alphabet and must not start with a digit. This value is required for all NAS Nodes.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this NAS Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination. While inserting new record following thing should be considered: Firstly,Realm and NAS-Identifier combination shall be unique across the NAS Nodes. Secondly, Realm and IP address combination shall be unique across the NAS Nodes.",
"maxLength": 255,
"minLength": 1,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"fqdn",
"nasNodeName",
"realm"
],
"type": "object"
}
Example
{
"fqdn": "fqdn.com",
"nasIPAddresses": [
"10.75.225.70",
"::125"
],
"nasIdentifier": "try",
"nasNodeName": "nasnode1",
"realm": "oracle.com"
}
delete /radius/nasnodes/{nasNodeName}
Deletes the specified NAS Node from the SOAM configuration. An NAS Node can only be deleted if all delete validation checks pass. In general, if the NAS Node is part of the configuration of some other Managed Object, the NAS Node cannot be deleted. An attempt to delete an NAS Node that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- nasNodeName: required (string)
Radius: Network Options
Network Options is a collection of network shared secret parameter that govern secret key aspects of network.
There is a single instance of this resource, which contains all of the individual networkoptions that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Network Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the networkoptions, and PUT is used to update one or more values within the set of networkoptions. A name for this single, non-deletable instance is neither required nor expected.
/radius/networkoptions
get /radius/networkoptions
Returns the set of current values for the Network Options.
Target Server: NOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/items/networkoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/networkoption/networkoption.json",
"properties": {
"networkScopedSharedSecret": {
"description": "A unique RADIUS Shared Secret to be used across the Network. It can contain characters: a-z, A-Z, 0-9, and the following special characters mentioned in pattern.",
"maxLength": 128,
"minLength": 10,
"pattern": "^[0-9a-zA-Z\\(\\'\\%\\_\\)\\+\\-\\[\\]\\{\\}\\=\\!\\@\\#\\$\\^\\&\\*\\:\\;\\,\\<\\>\\?.\\/\\~\\`\"\\|]+$",
"type": "string"
}
},
"required": [
"networkScopedSharedSecret"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"networkScopedSharedSecret": "!Networksecretcheck2"
},
"messages":
[
],
"links":
{
},
"status":
true
}
put /radius/networkoptions
Updates the Network Options with the values supplied. To update just one of the individual networkoptions, GET the set, modify the value for the networkoption that needs to be changed, and then PUT the Network Options.
Target Server: NOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/networkoption/networkoption.json",
"properties": {
"networkScopedSharedSecret": {
"description": "A unique RADIUS Shared Secret to be used across the Network. It can contain characters: a-z, A-Z, 0-9, and the following special characters mentioned in pattern.",
"maxLength": 128,
"minLength": 10,
"pattern": "^[0-9a-zA-Z\\(\\'\\%\\_\\)\\+\\-\\[\\]\\{\\}\\=\\!\\@\\#\\$\\^\\&\\*\\:\\;\\,\\<\\>\\?.\\/\\~\\`\"\\|]+$",
"type": "string"
}
},
"required": [
"networkScopedSharedSecret"
],
"type": "object"
}
Example
{
"networkScopedSharedSecret": "!Networksecretcheck2"
}
Response
HTTP status code 200
Radius: Radius Routing Tables
Radius Routing Table is an identification for telling about configuration related to routing rules of AVP values. If AVP is APN, then APN value should be provided. VRFID value and Auth MPN value to be provided only with AVP as VRFID. Only Auth MPN value is allowed to update. Radius AVP To Use, APN value or VRFID value is not allowed to change. Identifier for PUT, DELETE and GET ONE is either APN value or VRFID value.
All Radius Routing Table configuration is done at the SOAM.
/radius/radiusroutingtables
get /radius/radiusroutingtables
Returns all Radius Routing Table rules configured at the SOAM that meet the criteria specified in a valid GET request.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/collections/radiusroutingtableCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/radiusroutingtable/radiusroutingtable.json",
"properties": {
"apn": {
"description": "Access Point Name.",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
},
"authMpn": {
"description": "This specifies Radius request should go to MPN or not.",
"enum": [
"No",
"Yes"
],
"type": "string"
},
"keyAvp": {
"description": "This specifies Radius AVP whether it is Apn or VrfId.",
"enum": [
"Apn",
"VrfId"
],
"type": "string"
},
"vrfId": {
"description": "Virtual Route Forwarding Identifier.",
"maxLength": 10,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
}
},
"required": [
"keyAvp"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"keyAvp": "VrfId",
"authMpn": "No",
"vrfId": "abc"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
post /radius/radiusroutingtables
Add a new Radius Routing Table rule to the DSR configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/radiusroutingtable/radiusroutingtable.json",
"properties": {
"apn": {
"description": "Access Point Name.",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
},
"authMpn": {
"description": "This specifies Radius request should go to MPN or not.",
"enum": [
"No",
"Yes"
],
"type": "string"
},
"keyAvp": {
"description": "This specifies Radius AVP whether it is Apn or VrfId.",
"enum": [
"Apn",
"VrfId"
],
"type": "string"
},
"vrfId": {
"description": "Virtual Route Forwarding Identifier.",
"maxLength": 10,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
}
},
"required": [
"keyAvp"
],
"type": "object"
}
Example
{
"keyAvp": "VrfId",
"authMpn": "No",
"vrfId": "abc"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/radius/radiusroutingtables/{apnvalueorvrfidvalue}
get /radius/radiusroutingtables/{apnvalueorvrfidvalue}
Returns the configuration details for the specified Radius Routing Table rule for a given APN value or VRFID value. If the specified Radius Routing Table rule does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- apnvalueorvrfidvalue: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/radius/items/radiusroutingtableItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/radiusroutingtable/radiusroutingtable.json",
"properties": {
"apn": {
"description": "Access Point Name.",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
},
"authMpn": {
"description": "This specifies Radius request should go to MPN or not.",
"enum": [
"No",
"Yes"
],
"type": "string"
},
"keyAvp": {
"description": "This specifies Radius AVP whether it is Apn or VrfId.",
"enum": [
"Apn",
"VrfId"
],
"type": "string"
},
"vrfId": {
"description": "Virtual Route Forwarding Identifier.",
"maxLength": 10,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
}
},
"required": [
"keyAvp"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"keyAvp": "VrfId",
"authMpn": "No",
"vrfId": "abc"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /radius/radiusroutingtables/{apnvalueorvrfidvalue}
Update is only supported to change Auth MPN value. Radius AVP To Use, APN value or VRFID value is not allowed to change in Radius Routing Table rule configuration.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- apnvalueorvrfidvalue: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/radius/radiusroutingtable/radiusroutingtable.json",
"properties": {
"apn": {
"description": "Access Point Name.",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
},
"authMpn": {
"description": "This specifies Radius request should go to MPN or not.",
"enum": [
"No",
"Yes"
],
"type": "string"
},
"keyAvp": {
"description": "This specifies Radius AVP whether it is Apn or VrfId.",
"enum": [
"Apn",
"VrfId"
],
"type": "string"
},
"vrfId": {
"description": "Virtual Route Forwarding Identifier.",
"maxLength": 10,
"pattern": "^[a-zA-Z0-9]([a-zA-Z0-9.-]*[a-zA-Z0-9])?$",
"type": "string"
}
},
"required": [
"keyAvp"
],
"type": "object"
}
Example
{
"keyAvp": "VrfId",
"authMpn": "No",
"vrfId": "abc"
}
delete /radius/radiusroutingtables/{apnvalueorvrfidvalue}
Deletes the specified Radius Routing Table rule from the SOAM configuration. An Radius Routing Table rule can only be deleted if all delete validation checks pass. In general, if the Radius Routing Table rule is part of the configuration of some other Managed Object, the Radius Routing Table rule cannot be deleted. An attempt to delete an Radius Routing Table rule that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- apnvalueorvrfidvalue: required (string)
Radius: Shared Secret Configuration Sets
A Shared Secret is an identification for telling about configuration related to Shared Secret.
All Shared Secret configuration is done at the SOAM.
/radius/sharedsecretconfigurationsets
/radius/sharedsecretconfigurationsets/{sharedSecretName}
Rbar: Addresses Range
The Address Range provides the mapping between a single address range and a Destination for routing.
/rbar/addressranges
get /rbar/addressranges
Returns all Address Ranges configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Address Ranges meeting the request parameters are returned in the response.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/addressrangeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressrange/addressrange.json",
"properties": {
"routingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"endAddr": {
"description": "End Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"id": {
"description": "The natural identifier for the Address Range instance (which has no name). It is a combination of tableame-startaddress-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-startaddress only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"startAddr": {
"description": "Start Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"destination",
"endAddr",
"startAddr",
"tableName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"routingEntity": "Imsi",
"startAddr": "111111111111111",
"endAddr": "222222222222222",
"tableName": "AutImsi",
"destination": "AutDestination1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /rbar/addressranges
Adds a new Address Range to the RBAR configuration. The Start Address and End Address for an Address Range shall not be overlapping or shall not already exists in the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressrange/addressrange.json",
"properties": {
"routingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"endAddr": {
"description": "End Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"id": {
"description": "The natural identifier for the Address Range instance (which has no name). It is a combination of tableame-startaddress-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-startaddress only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"startAddr": {
"description": "Start Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"destination",
"endAddr",
"startAddr",
"tableName"
],
"type": "object"
}
Example
{
"routingEntity": "Imsi",
"startAddr": "111111111111111",
"endAddr": "222222222222222",
"tableName": "AutImsi",
"destination": "AutDestination1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/rbar/addressranges/{id}
get /rbar/addressranges/{id}
Returns the configuration details for the specified Address Range. If the specified Address Range does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/addressrangeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressrange/addressrange.json",
"properties": {
"routingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"endAddr": {
"description": "End Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"id": {
"description": "The natural identifier for the Address Range instance (which has no name). It is a combination of tableame-startaddress-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-startaddress only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"startAddr": {
"description": "Start Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"destination",
"endAddr",
"startAddr",
"tableName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"routingEntity": "Imsi",
"startAddr": "111111111111111",
"endAddr": "222222222222222",
"tableName": "AutImsi",
"destination": "AutDestination1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /rbar/addressranges/{id}
Updates the configuration for the specified Address Range. If the provided Address Range data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressrange/addressrange.json",
"properties": {
"routingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"endAddr": {
"description": "End Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"id": {
"description": "The natural identifier for the Address Range instance (which has no name). It is a combination of tableame-startaddress-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-startaddress only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"startAddr": {
"description": "Start Address of the range.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"destination",
"endAddr",
"startAddr",
"tableName"
],
"type": "object"
}
Example
{
"routingEntity": "Imsi",
"startAddr": "111111111111111",
"endAddr": "222222222222222",
"tableName": "AutImsi",
"destination": "AutDestination1"
}
delete /rbar/addressranges/{id}
Deletes the specified Address Range from the SOAM configuration. An Address Range will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Rbar: Address Resolutions
Address Resolutions allows to define the routing relationship between message content and an address by mapping a Diameter Application ID, Command Code, and Routing Entity Type to a user-configured address (a range or individual address). An Address Resolution supports up to three prioritized Routing Entity Types for each Application ID and Command Code (highest priority - Primary Routing Entity Type - and lowest priority - Tertiary Routing Entity Type).
/rbar/addressresolutions
get /rbar/addressresolutions
Returns all Address Resolutions configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Address Resolutions meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/addressresolutionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"id": {
"description": "The natural identifier for the Address Resolution instance (which has no name). It is a combination of applId-cmdCode.",
"readOnly": true,
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for primary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for secondary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for tertiary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityAddrTableName",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityAddrTableName": "AutImsi",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn",
"secondaryRoutingEntityAddrTableName": "AutMsisdn",
"tertiaryRoutingEntity": "ExternalId",
"tertiaryRoutingEntityPrimaryAvp": "UserIdentifierExternalId",
"tertiaryRoutingEntityAddrTableName": "AutExtDomainId"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /rbar/addressresolutions
Adds a new Address resolution to the DSR configuration. The new Address resolution must have an Application Id and Command Code combination that is unique to the SOAM's configuration
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"id": {
"description": "The natural identifier for the Address Resolution instance (which has no name). It is a combination of applId-cmdCode.",
"readOnly": true,
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for primary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for secondary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for tertiary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityAddrTableName",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
}
Example
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityAddrTableName": "AutImsi",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn",
"secondaryRoutingEntityAddrTableName": "AutMsisdn",
"tertiaryRoutingEntity": "ExternalId",
"tertiaryRoutingEntityPrimaryAvp": "UserIdentifierExternalId",
"tertiaryRoutingEntityAddrTableName": "AutExtDomainId"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/rbar/addressresolutions/{id}
get /rbar/addressresolutions/{id}
Returns the configuration details for the specified Address resolution. If the specified Address resolution does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/addressresolutionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"id": {
"description": "The natural identifier for the Address Resolution instance (which has no name). It is a combination of applId-cmdCode.",
"readOnly": true,
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for primary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for secondary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for tertiary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityAddrTableName",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityAddrTableName": "AutImsi",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn",
"secondaryRoutingEntityAddrTableName": "AutMsisdn",
"tertiaryRoutingEntity": "ExternalId",
"tertiaryRoutingEntityPrimaryAvp": "UserIdentifierExternalId",
"tertiaryRoutingEntityAddrTableName": "AutExtDomainId"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /rbar/addressresolutions/{id}
Updates the configuration for the specified Address Resolution. If the provided Address Resolution data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addressresolution/addressresolution.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"cmdCode": {
"description": "Command Code value in Diameter message.",
"maxLength": 30,
"type": "string"
},
"id": {
"description": "The natural identifier for the Address Resolution instance (which has no name). It is a combination of applId-cmdCode.",
"readOnly": true,
"type": "string"
},
"primaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"primaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for primary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"primaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"primaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Primary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"secondaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for secondary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"secondaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"secondaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Secondary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi or Impu) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"tertiaryRoutingEntityAddrTableName": {
"description": "Address Table name (/rbar/addresstables) for tertiary routing entity type.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"tertiaryRoutingEntityPrimaryAvp": {
"description": "Primary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
},
"tertiaryRoutingEntitySecondaryAvp": {
"description": "Secondary AVP which will be used for extracting the Tertiary Routing Entity address.",
"enum": [
"PublicIdentity",
"SvcInfoSubscrId0",
"SvcInfoSubscrId1",
"SvcInfoSubscrId2",
"SvcInfoSubscrId3",
"SvcInfoSubscrId4",
"SubscriptionId0",
"SubscriptionId1",
"SubscriptionId2",
"SubscriptionId3",
"SubscriptionId4",
"UserIdentityMsisdn",
"UserIdentityPublic",
"UserName",
"FramedIpAddress",
"FramedIpv6Prefix",
"SvcInfoPsInfo3gppcc",
"Msisdn",
"UserIdentifierMsisdn",
"UserIdentifierUserName",
"UserIdentifierExternalId",
"DeviceActionExternalId"
],
"type": "string"
}
},
"required": [
"applId",
"cmdCode",
"primaryRoutingEntity",
"primaryRoutingEntityAddrTableName",
"primaryRoutingEntityPrimaryAvp"
],
"type": "object"
}
Example
{
"applId": 167777251,
"cmdCode": "316",
"primaryRoutingEntity": "Imsi",
"primaryRoutingEntityPrimaryAvp": "SvcInfoSubscrId1",
"primaryRoutingEntityAddrTableName": "AutImsi",
"secondaryRoutingEntity": "Msisdn",
"secondaryRoutingEntityPrimaryAvp": "UserIdentityMsisdn",
"secondaryRoutingEntityAddrTableName": "AutMsisdn",
"tertiaryRoutingEntity": "ExternalId",
"tertiaryRoutingEntityPrimaryAvp": "UserIdentifierExternalId",
"tertiaryRoutingEntityAddrTableName": "AutExtDomainId"
}
delete /rbar/addressresolutions/{id}
Deletes the specified Address Resolution from the SOAM configuration. An Address resolution will only be deleted if all delete validation checks pass. If the Address resolution is part of the configuration of some other Managed Object, the Address Resolution cannot be deleted.
Target Server: SOAM
Secured by x-other
Rbar: Address Tables
Allows user to access an Address Table and its associated attributes.
/rbar/addresstables
get /rbar/addresstables
Returns all Address Table configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Address Tables meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/addresstableCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addresstable/addresstable.json",
"properties": {
"name": {
"description": "Unique name of the Address Table. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"comment": {
"description": "Purpose of the Address Table. Valid comments are strings between one and 64 characters, inclusive.",
"maxLength": 64,
"type": "string"
},
"routingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
}
},
"required": [
"name",
"routingEntity"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "AutImsi1",
"comment": "Comment1",
"routingEntity": 'Imsi'
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /rbar/addresstables
Adds a new Address Table to the RBAR configuration. The new Address Table must have a name that is unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addresstable/addresstable.json",
"properties": {
"name": {
"description": "Unique name of the Address Table. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"comment": {
"description": "Purpose of the Address Table. Valid comments are strings between one and 64 characters, inclusive.",
"maxLength": 64,
"type": "string"
},
"routingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
}
},
"required": [
"name",
"routingEntity"
],
"type": "object"
}
Example
{
"name": "AutImsi1",
"comment": "Comment1",
"routingEntity": 'Imsi'
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/rbar/addresstables/{name}
get /rbar/addresstables/{name}
Returns the configuration details for the specified Address Table. If the specified Address Table does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/addresstableItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/addresstable/addresstable.json",
"properties": {
"name": {
"description": "Unique name of the Address Table. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"comment": {
"description": "Purpose of the Address Table. Valid comments are strings between one and 64 characters, inclusive.",
"maxLength": 64,
"type": "string"
},
"routingEntity": {
"description": "Type of Routing Entity. A Routing Entity can be a User Identity (Imsi, Msisdn, Impi, Impu or External Identifier) or an IP Address associated with the User Equipment (Ipv4, Ipv6PfxAddr or Unsigned16).",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
}
},
"required": [
"name",
"routingEntity"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "AutImsi1",
"comment": "Comment1",
"routingEntity": 'Imsi'
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /rbar/addresstables/{name}
Deletes the specified Address Table from the SOAM configuration. Address Table will only be deleted if all delete validation checks pass. If the Address Table is part of the configuration of some other Managed Object, the Address Table cannot be deleted. An attempt to delete an Address Table that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Rbar: Destinations
Destinations contains the attributes associated with a destination to which RBAR routes a message. RBAR uses these attributes to modify the contents of a received message before forwarding the message. Each destination can be configured with any combination of a Realm and FQDN such as Realm-only, FQDN-only, or Realm and FQDN
/rbar/destinations
get /rbar/destinations
Returns all Destinations configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Destinations meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section)
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/destinationCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/destination/destination.json",
"properties": {
"avpInsertion": {
"description": "If set to true, subsequent invocation of RBAR on a different node in the network is allowed. If the System Options Allow Subsequent RBAR Invocation (/rbar/options) is true, then this per-Destination attribute will be ignored.",
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name":"AutomDestination1",
"realm":"oracle.com",
"fqdn":"fqdn1.oracle.com",
"avpInsertion":true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /rbar/destinations
Adds a new Destination to the RBAR configuration. The new Destination must have a name that is unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/destination/destination.json",
"properties": {
"avpInsertion": {
"description": "If set to true, subsequent invocation of RBAR on a different node in the network is allowed. If the System Options Allow Subsequent RBAR Invocation (/rbar/options) is true, then this per-Destination attribute will be ignored.",
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name":"AutomDestination1",
"realm":"oracle.com",
"fqdn":"fqdn1.oracle.com",
"avpInsertion":true
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/rbar/destinations/{name}
get /rbar/destinations/{name}
Returns the configuration details for the specified Destination. If the specified Destination does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/destinationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/destination/destination.json",
"properties": {
"avpInsertion": {
"description": "If set to true, subsequent invocation of RBAR on a different node in the network is allowed. If the System Options Allow Subsequent RBAR Invocation (/rbar/options) is true, then this per-Destination attribute will be ignored.",
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name":"AutomDestination1",
"realm":"oracle.com",
"fqdn":"fqdn1.oracle.com",
"avpInsertion":true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /rbar/destinations/{name}
Updates the configuration for the specified Destination. If the provided Destination data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/destination/destination.json",
"properties": {
"avpInsertion": {
"description": "If set to true, subsequent invocation of RBAR on a different node in the network is allowed. If the System Options Allow Subsequent RBAR Invocation (/rbar/options) is true, then this per-Destination attribute will be ignored.",
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"name": {
"description": "Unique name of the Destination. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name":"AutomDestination1",
"realm":"oracle.com",
"fqdn":"fqdn1.oracle.com",
"avpInsertion":true
}
delete /rbar/destinations/{name}
Deletes the specified Destination from the SOAM configuration. A Destination will only be deleted if all delete validation checks pass. If the Destination is part of the configuration of some other Managed Object, the Destination cannot be deleted. For example, if the Destination is associated with an Exception (/rbar/exception), that association must first be removed and then the Destination can be deleted from the configuration. An attempt to delete Destination that cannot be deleted will result in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Rbar: Domain Addresses
Domain Address provides a mapping between a domain address and the destination for routing.
/rbar/domainaddresses
get /rbar/domainaddresses
Returns all Domain Addresses configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Domain Addresses meeting the request parameters as returned in the response.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/domainaddressCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/domainaddress/domainaddress.json",
"properties": {
"routingEntity": {
"description": "Routing Entity Type of the Address.",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "It is a Routing Entity Address. Below pregmatch checks all combination as defined here. Routing Entity type Imsi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Msisdn: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impu: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Ipv4: [Default=n/a; Range = A 15 character string in quad-dotted format. Valid characters are numeric (0-9) and dot (.)]. Routing Entity type Ipv6 Prefix: [Default=n/a; Range = A valid IPv6 address of 39 characters consisting of hexadecimal (0-9, A-F, a-f) and colon (:)]. Routing Entity type Unsigned16: [Default=n/a; Range = 0 - FFFF]. Routing Entity type ExternalId: [Default=n/a; Range = A 1 - 128 character string to identify the subscriber's domain. Valid characters are non-blank printable ASCII characters (0x21 - 0x7F)]. Note1: This is the IPv6 address part of the IPv6 prefix address. Note2: If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: 0001:0001:: for prefix length 28 is invalid as the 32nd bit is set. Note3: Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: 8:: for prefix length 1 is invalid as 8:: is treated as 0008::",
"minLength": 1,
"maxLength": 128,
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$|^([a-zA-Z0-9])[\\.a-zA-Z0-9]{1,64}|[0-9]{1,20}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"routingEntity": "ExternalId",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutExtIdDomainOne",
"nestedTableName": "AutExtIdLocalOne",
"routingEntityComp": "DomainIdentifier"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /rbar/domainaddresses
Adds a new Domain Address to the RBAR configuration. The new Domain Address must have Address and Table Name that is unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/domainaddress/domainaddress.json",
"properties": {
"routingEntity": {
"description": "Routing Entity Type of the Address.",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "It is a Routing Entity Address. Below pregmatch checks all combination as defined here. Routing Entity type Imsi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Msisdn: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impu: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Ipv4: [Default=n/a; Range = A 15 character string in quad-dotted format. Valid characters are numeric (0-9) and dot (.)]. Routing Entity type Ipv6 Prefix: [Default=n/a; Range = A valid IPv6 address of 39 characters consisting of hexadecimal (0-9, A-F, a-f) and colon (:)]. Routing Entity type Unsigned16: [Default=n/a; Range = 0 - FFFF]. Routing Entity type ExternalId: [Default=n/a; Range = A 1 - 128 character string to identify the subscriber's domain. Valid characters are non-blank printable ASCII characters (0x21 - 0x7F)]. Note1: This is the IPv6 address part of the IPv6 prefix address. Note2: If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: 0001:0001:: for prefix length 28 is invalid as the 32nd bit is set. Note3: Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: 8:: for prefix length 1 is invalid as 8:: is treated as 0008::",
"minLength": 1,
"maxLength": 128,
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$|^([a-zA-Z0-9])[\\.a-zA-Z0-9]{1,64}|[0-9]{1,20}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
}
Example
{
"routingEntity": "ExternalId",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutExtIdDomainOne",
"nestedTableName": "AutExtIdLocalOne",
"routingEntityComp": "DomainIdentifier"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/rbar/domainaddresses/{id}
get /rbar/domainaddresses/{id}
Returns the configuration details for the specified Domain Address. If the specified Domain Address does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/domainaddressItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/domainaddress/domainaddress.json",
"properties": {
"routingEntity": {
"description": "Routing Entity Type of the Address.",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "It is a Routing Entity Address. Below pregmatch checks all combination as defined here. Routing Entity type Imsi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Msisdn: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impu: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Ipv4: [Default=n/a; Range = A 15 character string in quad-dotted format. Valid characters are numeric (0-9) and dot (.)]. Routing Entity type Ipv6 Prefix: [Default=n/a; Range = A valid IPv6 address of 39 characters consisting of hexadecimal (0-9, A-F, a-f) and colon (:)]. Routing Entity type Unsigned16: [Default=n/a; Range = 0 - FFFF]. Routing Entity type ExternalId: [Default=n/a; Range = A 1 - 128 character string to identify the subscriber's domain. Valid characters are non-blank printable ASCII characters (0x21 - 0x7F)]. Note1: This is the IPv6 address part of the IPv6 prefix address. Note2: If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: 0001:0001:: for prefix length 28 is invalid as the 32nd bit is set. Note3: Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: 8:: for prefix length 1 is invalid as 8:: is treated as 0008::",
"minLength": 1,
"maxLength": 128,
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$|^([a-zA-Z0-9])[\\.a-zA-Z0-9]{1,64}|[0-9]{1,20}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"routingEntity": "ExternalId",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutExtIdDomainOne",
"nestedTableName": "AutExtIdLocalOne",
"routingEntityComp": "DomainIdentifier"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /rbar/domainaddresses/{id}
Updates the configuration for the specified Domain Address. If the provided Domain Address data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/domainaddress/domainaddress.json",
"properties": {
"routingEntity": {
"description": "Routing Entity Type of the Address.",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "It is a Routing Entity Address. Below pregmatch checks all combination as defined here. Routing Entity type Imsi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Msisdn: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impi: [Default=n/a; Range = A 15 digit string. Valid digits are 0 - 9]. Routing Entity type Impu: [Default=n/a; Range = A 3 - 15 digit string. Valid digits are 0 - 9]. Routing Entity type Ipv4: [Default=n/a; Range = A 15 character string in quad-dotted format. Valid characters are numeric (0-9) and dot (.)]. Routing Entity type Ipv6 Prefix: [Default=n/a; Range = A valid IPv6 address of 39 characters consisting of hexadecimal (0-9, A-F, a-f) and colon (:)]. Routing Entity type Unsigned16: [Default=n/a; Range = 0 - FFFF]. Routing Entity type ExternalId: [Default=n/a; Range = A 1 - 128 character string to identify the subscriber's domain. Valid characters are non-blank printable ASCII characters (0x21 - 0x7F)]. Note1: This is the IPv6 address part of the IPv6 prefix address. Note2: If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: 0001:0001:: for prefix length 28 is invalid as the 32nd bit is set. Note3: Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: 8:: for prefix length 1 is invalid as 8:: is treated as 0008::",
"minLength": 1,
"maxLength": 128,
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$|^([a-zA-Z0-9])[\\.a-zA-Z0-9]{1,64}|[0-9]{1,20}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
}
Example
{
"routingEntity": "ExternalId",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutExtIdDomainOne",
"nestedTableName": "AutExtIdLocalOne",
"routingEntityComp": "DomainIdentifier"
}
delete /rbar/domainaddresses/{id}
Deletes the specified Domain Address from the SOAM configuration. A Domain Address will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Rbar: Individual Addresses
Individual Address provides the mapping between an individual address and a Destination for routing.
/rbar/individualaddresses
get /rbar/individualaddresses
Returns all Individual Addresses configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Individual Addresses meeting the request parameters are returned in the response.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/individualaddressCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/individualaddress/individualaddress.json",
"properties": {
"routingEntity": {
"description": "TBD",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "Address can be IPv4 or IPv6. Note that If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: '0001:0001::' for prefix length 28 is invalid as the 32nd bit is set. Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: '8::' for prefix length 1 is invalid as '8::' is treated as '0008::'.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"routingEntity": "Imsi",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutImsi"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /rbar/individualaddresses
Adds a new Individual Address to the RBAR configuration. The new Individual Address must have Address and Table Name that is unique to the SOAM's configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/individualaddress/individualaddress.json",
"properties": {
"routingEntity": {
"description": "TBD",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "Address can be IPv4 or IPv6. Note that If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: '0001:0001::' for prefix length 28 is invalid as the 32nd bit is set. Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: '8::' for prefix length 1 is invalid as '8::' is treated as '0008::'.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
}
Example
{
"routingEntity": "Imsi",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutImsi"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/rbar/individualaddresses/{id}
get /rbar/individualaddresses/{id}
Returns the configuration details for the specified Individual Address. If the specified Individual Address does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/individualaddressItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/individualaddress/individualaddress.json",
"properties": {
"routingEntity": {
"description": "TBD",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "Address can be IPv4 or IPv6. Note that If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: '0001:0001::' for prefix length 28 is invalid as the 32nd bit is set. Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: '8::' for prefix length 1 is invalid as '8::' is treated as '0008::'.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"routingEntity": "Imsi",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutImsi"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /rbar/individualaddresses/{id}
Updates the configuration for the specified Individual Address. If the provided Individual Address data is invalid in any way, the update will fail, resulting in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/individualaddress/individualaddress.json",
"properties": {
"routingEntity": {
"description": "TBD",
"enum": [
"Imsi",
"Msisdn",
"Impi",
"Impu",
"Ipv4",
"Ipv6PfxAddr",
"Unsigned16",
"ExternalId"
],
"type": "string"
},
"routingEntityComp": {
"description": "Routing Entity Component of the Address which is required only if Routing Entity Type is External Identifier.",
"enum": [
"LocalIdentifier",
"DomainIdentifier"
],
"type": "string"
},
"address": {
"description": "Address can be IPv4 or IPv6. Note that If the IPv6 address part of the IPv6 prefix is expressed in binary form (converting hexadecimal digits to bits), no bit which is set (value=1),can be at an index that is greater than the configured IPv6 Prefix Length. For example: '0001:0001::' for prefix length 28 is invalid as the 32nd bit is set. Trailing zeros can be dropped in IPv6 address part of the IPv6 prefix but not leading zeros.For example: '8::' for prefix length 1 is invalid as '8::' is treated as '0008::'.",
"type": "string",
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^([0-9]){1,15}$"
},
"destination": {
"description": "Destination name of the address (/rbar/destinations)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"id": {
"description": "The natural identifier for the Individual Address instance (which has no name). It is a combination of tablename-address-prefixlength(only if prefix length configured) otherwise identifier comprises of tablename-address only.",
"readOnly": true,
"type": "string"
},
"ipv6PfxLength": {
"description": "Prefix length of IPv6-prefix address. This is applicable when routing entity is Ipv6PfxAddr.",
"maximum": 128,
"minimum": 1,
"type": "integer"
},
"tableName": {
"description": "Table name of the address table (/rbar/addresstables)",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nestedTableName": {
"description": "Address Table for next level search using the local Identifier of External Identifier AVP.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"routingEntity",
"address",
"destination",
"tableName"
],
"type": "object"
}
Example
{
"routingEntity": "Imsi",
"address": "111111111111111",
"destination": "AutDestination1",
"tableName": "AutImsi"
}
delete /rbar/individualaddresses/{id}
Deletes the specified Individual Address from the SOAM configuration. An Individual Address will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Rbar: Options
Options (sometimes referred to as System Options) is a collection of parameters that govern various aspects of RBAR global parameters.
There is a single instance of this resource, which contains all of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
/rbar/options
get /rbar/options
Returns the set of current values for the Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/optionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/option/option.json",
"properties": {
"allowSubsequentDSRAppInvoc": {
"description": "If set to true, subsequent invocation of RBAR on a different node in the network is allowed.",
"type": "boolean"
},
"asciiExcludedList": {
"items": {
"description": "A list of ASCII characters to ignore while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"type": "string",
"pattern": "^[0-9a-zA-Z\\(\\'\\)\\+\\-\\[\\]\\{\\}\\=\\!\\@\\#\\$\\^\\&\\*\\:\\;\\,\\<\\>\\?.\\/\\~\\`\"\\|]+$"
},
"type": "array"
},
"excludeSpace": {
"description": "If set to true, ASCII character space is ignored while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"removeDestHost": {
"description": "If set to true, RBAR deletes any instance of 'Destination-Host' AVPs in the message when performing 'Realm only' resolution.",
"type": "boolean"
},
"resExhaustionErrCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhaustionErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"resExhaustionVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"tbcdExcludedList": {
"items": {
"description": "Character is ignored while parsing digits from a raw AVP data field of AVP Type OctetString encoded as a TBCD-string.",
"enum": ["*","#","a","b","c"],
"type": "string"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"unavailableAppAction": {
"description": "Action to be taken when RBAR application is unavailable to process messages.",
"enum": [
"ContinueRouting",
"DefaultRoute",
"SendAnswer",
"SendAnsExp"
],
"type": "string"
},
"unavailableAppErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of RBAR application being unavailable.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"unavailableAppResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of RBAR application being unavailable. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"unavailableAppRouteList": {
"description": "If the Unavailability Action is 'Default Route' and RBAR application is not available, the requests will be routed using this Route List and Peer Routing Rules will be bypassed.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"unavailableAppVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of RBAR application being unavailable.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"uriSupported": {
"description": "If set to true, both Local and Global Numbers are valid addresses for IMPU and MSISDN decoded from Diameter Requests. If set to false, only Global Numbers are valid addresses. URI Local Numbers Supported defines whether Local Numbers are considered valid addresses within a SIP or TEL URI. This only applies to the Routing Entity Type 'IMPU' and 'MSISDN'. An address of this form is consider a 'Local Number' if it does not start with the Global Number prefix character '+'.",
"type": "boolean"
}
},
"required": [
"resExhaustionErrCode"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"asciiExcludedList": [
"a",
"w"
],
"excludeSpace": false,
"tbcdExcludedList": [
"#"
],
"allowSubsequentDSRAppInvoc": false,
"removeDestHost": true,
"realm": "oracle.com",
"fqdn": "fqdn1.oracle.com",
"resExhaustionErrCode": 3004,
"resExhaustionErrMsg": "RBAR Resource Exhausted",
"resExhaustionVendorId": 23,
"unavailableAppAction": "SendAnsExp",
"unavailableAppRouteList": "Default",
"unavailableAppResultCode": 3002,
"unavailableAppErrMsg": "RBAR Unavailable",
"unavailableAppVendorId": 23,
"uriSupported": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
put /rbar/options
Updates the Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, and then PUT the Options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/option/option.json",
"properties": {
"allowSubsequentDSRAppInvoc": {
"description": "If set to true, subsequent invocation of RBAR on a different node in the network is allowed.",
"type": "boolean"
},
"asciiExcludedList": {
"items": {
"description": "A list of ASCII characters to ignore while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"type": "string",
"pattern": "^[0-9a-zA-Z\\(\\'\\)\\+\\-\\[\\]\\{\\}\\=\\!\\@\\#\\$\\^\\&\\*\\:\\;\\,\\<\\>\\?.\\/\\~\\`\"\\|]+$"
},
"type": "array"
},
"excludeSpace": {
"description": "If set to true, ASCII character space is ignored while parsing digits from a raw AVP data field of AVP Type UTF8String.",
"type": "boolean"
},
"fqdn": {
"description": "Fully Qualified Domain Name of this Peer Node. fqdn is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and an FQDN must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"realm": {
"description": "Realm of this Local Node. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"removeDestHost": {
"description": "If set to true, RBAR deletes any instance of 'Destination-Host' AVPs in the message when performing 'Realm only' resolution.",
"type": "boolean"
},
"resExhaustionErrCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"resExhaustionErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"resExhaustionVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of internal resource being exhausted.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"tbcdExcludedList": {
"items": {
"description": "Character is ignored while parsing digits from a raw AVP data field of AVP Type OctetString encoded as a TBCD-string.",
"enum": ["*","#","a","b","c"],
"type": "string"
},
"maxItems": 5,
"minItems": 0,
"type": "array"
},
"unavailableAppAction": {
"description": "Action to be taken when RBAR application is unavailable to process messages.",
"enum": [
"ContinueRouting",
"DefaultRoute",
"SendAnswer",
"SendAnsExp"
],
"type": "string"
},
"unavailableAppErrMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message when a message is not successfully routed because of RBAR application being unavailable.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"unavailableAppResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message when a message is not successfully routed because of RBAR application being unavailable. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"unavailableAppRouteList": {
"description": "If the Unavailability Action is 'Default Route' and RBAR application is not available, the requests will be routed using this Route List and Peer Routing Rules will be bypassed.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"unavailableAppVendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message when a message is not successfully routed because of RBAR application being unavailable.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
},
"uriSupported": {
"description": "If set to true, both Local and Global Numbers are valid addresses for IMPU and MSISDN decoded from Diameter Requests. If set to false, only Global Numbers are valid addresses. URI Local Numbers Supported defines whether Local Numbers are considered valid addresses within a SIP or TEL URI. This only applies to the Routing Entity Type 'IMPU' and 'MSISDN'. An address of this form is consider a 'Local Number' if it does not start with the Global Number prefix character '+'.",
"type": "boolean"
}
},
"required": [
"resExhaustionErrCode"
],
"type": "object"
}
Example
{
"asciiExcludedList": [
"a",
"w"
],
"excludeSpace": false,
"tbcdExcludedList": [
"#"
],
"allowSubsequentDSRAppInvoc": false,
"removeDestHost": true,
"realm": "oracle.com",
"fqdn": "fqdn1.oracle.com",
"resExhaustionErrCode": 3004,
"resExhaustionErrMsg": "RBAR Resource Exhausted",
"resExhaustionVendorId": 23,
"unavailableAppAction": "SendAnsExp",
"unavailableAppRouteList": "Default",
"unavailableAppResultCode": 3002,
"unavailableAppErrMsg": "RBAR Unavailable",
"unavailableAppVendorId": 23,
"uriSupported": true
}
Response
HTTP status code 200
Rbar: Routing Exceptions
Exception (sometimes referred to as Routing Exception) allows you to specify the routing exception action to take when RBAR is unable to resolve an address to a Destination for each supported Diameter Application and Routing Exception Type. There are three (3) Routing Exception entries (No Address Match, No valid Routing Entity Address, and Unknown Command Code) automatically inserted with the Routing Exception Action set to Forward Unchanged as the default action for a supported Diameter application entry when that application entry is added. Similarly, these Routing Exceptions that are associated with an application entry are automatically deleted when that application entry is deleted
/rbar/routingexceptions
get /rbar/routingexceptions
Returns all Routing Exception configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Routing Exception meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/routingexceptionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/routingexception/routingexception.json",
"properties": {
"action": {
"description": "Action to be taken on exception.",
"enum": [
"AbandonRequest",
"FwdUnchanged",
"FwdToDest",
"SendAnswer",
"SendAnsExp"
],
"type": "string"
},
"ansResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message on exception. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"readOnly": true,
"type": "integer"
},
"destName": {
"description": "Destination to which message will be forwarded on exception",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"errMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message on exception.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"exceptionType": {
"description": "Type of Routing Exception.",
"enum": [
"UnknownCmdCode",
"NoRoutingEntityAddress",
"NoDrtEntry"
],
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the Routing Exception instance (which has no name). It is a combination of applId-exceptionType.",
"readOnly": true,
"type": "string"
},
"vendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message on exception.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"applId"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"applId": 16777251,
"exceptionType": "NoRoutingEntityAddress",
"action": "FwdUnchanged"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
/rbar/routingexceptions/{id}
get /rbar/routingexceptions/{id}
Returns the configuration details for the specified Routing Exception. If the specified Routing Exception does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/routingexceptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/routingexception/routingexception.json",
"properties": {
"action": {
"description": "Action to be taken on exception.",
"enum": [
"AbandonRequest",
"FwdUnchanged",
"FwdToDest",
"SendAnswer",
"SendAnsExp"
],
"type": "string"
},
"ansResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message on exception. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"readOnly": true,
"type": "integer"
},
"destName": {
"description": "Destination to which message will be forwarded on exception",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"errMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message on exception.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"exceptionType": {
"description": "Type of Routing Exception.",
"enum": [
"UnknownCmdCode",
"NoRoutingEntityAddress",
"NoDrtEntry"
],
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the Routing Exception instance (which has no name). It is a combination of applId-exceptionType.",
"readOnly": true,
"type": "string"
},
"vendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message on exception.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"applId"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"applId": 16777251,
"exceptionType": "NoRoutingEntityAddress",
"action": "FwdUnchanged"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /rbar/routingexceptions/{id}
Updates the Routing Exception with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, and then PUT the Options.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/routingexception/routingexception.json",
"properties": {
"action": {
"description": "Action to be taken on exception.",
"enum": [
"AbandonRequest",
"FwdUnchanged",
"FwdToDest",
"SendAnswer",
"SendAnsExp"
],
"type": "string"
},
"ansResultCode": {
"description": "The Result-Code or Experimental-Result-Code value to be returned in an Answer message on exception. If Vendor-Id is configured, this value is encoded as Experimental-Result-Code AVP else Result-Code AVP.",
"maximum": 5999,
"minimum": 1000,
"type": "integer"
},
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"readOnly": true,
"type": "integer"
},
"destName": {
"description": "Destination to which message will be forwarded on exception",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"errMsg": {
"description": "The Error-Message AVP value to be returned in an Answer message on exception.",
"maxLength": 64,
"minLength": 0,
"type": "string"
},
"exceptionType": {
"description": "Type of Routing Exception.",
"enum": [
"UnknownCmdCode",
"NoRoutingEntityAddress",
"NoDrtEntry"
],
"readOnly": true,
"type": "string"
},
"id": {
"description": "The natural identifier for the Routing Exception instance (which has no name). It is a combination of applId-exceptionType.",
"readOnly": true,
"type": "string"
},
"vendorId": {
"description": "The Vendor-Id AVP value to be returned in an Answer message on exception.",
"maximum": 4294967295,
"minimum": 1,
"type": "integer"
}
},
"required": [
"applId"
],
"type": "object"
}
Example
{
"applId": 16777251,
"exceptionType": "NoRoutingEntityAddress",
"action": "FwdUnchanged"
}
Rbar: Supported Applications
Applications(sometimes referred to as Supported Applications) allows user to access a list of Diameter Applications supported by RBAR
/rbar/supportedapplications
get /rbar/supportedapplications
Returns all Applications configured at the SOAM that meet the criteria specified in a valid GET request. If valid paging parameters are provided in the request, only those Supported Applications meeting the request parameters are returned in the response. If paging parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/collections/supportedapplicationCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/supportedapplication/supportedapplication.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"routingMode": {
"description": "Routing Mode.",
"type": "string"
}
},
"required": [
"applId"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"applId": 16777251,
"routingMode": "Proxy"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /rbar/supportedapplications
Adds a new Application to the RBAR configuration. The new Application must be unique to the SOAM's configuration
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/supportedapplication/supportedapplication.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"routingMode": {
"description": "Routing Mode.",
"type": "string"
}
},
"required": [
"applId"
],
"type": "object"
}
Example
{
"applId": 16777251,
"routingMode": "Proxy"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/rbar/supportedapplications/{id}
get /rbar/supportedapplications/{id}
Returns the configuration details for the specified Application. If the specified Application does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- id: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/items/supportedapplicationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/rbar/supportedapplication/supportedapplication.json",
"properties": {
"applId": {
"description": "The Application Id is the numeric value used to identify a Diameter Application.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"routingMode": {
"description": "Routing Mode.",
"type": "string"
}
},
"required": [
"applId"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"applId": 16777251,
"routingMode": "Proxy"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /rbar/supportedapplications/{id}
Deletes the specified Application from the SOAM configuration. An Application will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Sbr: Database Options
The maximum audit operation rate at which the database records are validated. The users may exchange the database audit rate based on, for example, Diameter signalling traffic load, the number of databases to be audited, and the size of the databases. The larger the rate it, the more impact on the system performance the audit may cause.
There is a single instance of this resource, which contains all of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Database Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the Database options, and PUT is used to update one or more values within the set of Database options. A name for this single, non-deletable instance is neither required nor expected.
/sbr/databaseoptions
get /sbr/databaseoptions
Returns the set of current values for the Database Options.
Target Server: NOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/items/databaseoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/databaseoption/databaseoption.json",
"properties": {
"auditOperationRate": {
"description": "The maximum rate at which the database records are validated. The users may exchange the database audit rate based on, for example, Diameter signalling traffic load, the number of databases to be audited, and the size of the databases. The larger the rate it, the more impact on the system performance the audit may cause.",
"maximum": 50000,
"minimum": 25000,
"default": 50000,
"type": "integer"
}
},
"required": [
"auditOperationRate"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"auditOperationRate": 50000
},
"messages":
[
],
"links":
{
},
"status":
true
}
put /sbr/databaseoptions
Updates the Database Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, and then PUT the Options.
Target Server: NOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/databaseoption/databaseoption.json",
"properties": {
"auditOperationRate": {
"description": "The maximum rate at which the database records are validated. The users may exchange the database audit rate based on, for example, Diameter signalling traffic load, the number of databases to be audited, and the size of the databases. The larger the rate it, the more impact on the system performance the audit may cause.",
"maximum": 50000,
"minimum": 25000,
"default": 50000,
"type": "integer"
}
},
"required": [
"auditOperationRate"
],
"type": "object"
}
Example
{
"auditOperationRate": 50000
}
Response
HTTP status code 200
Sbr: SBR Database Resizing Plans
An SBR Database Resizing plan allows for changing the size of a running SBR Database. Resizing Plans can be configured prior to the start of the plans execution.
SBR Data Migration Plans are configurable only on an Active NO, but are viewable on NOAM and SOAM servers.
/sbr/databaseresizingplans
get /sbr/databaseresizingplans
Returns all Database Resizing plans configured at the NOAM that meet the criteria specified in a valid GET request. If valid parameters are provided in the request, only those Database Resizing plans meeting the request parameters are returned in the response. If parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/collections/databaseresizingplanCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/databaseresizingplan/databaseresizingplan.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"type": "string",
"readOnly": true
},
"initialNumOfServerGroups": {
"description": "The number of Server Groups hosting this database.",
"type": "integer",
"readOnly": true
},
"initialResourceDomainName": {
"description": "The Resource Domain configured for the selected database.",
"type": "string",
"readOnly": true
},
"planName": {
"description": "A name that uniquely identifies the SBR Database Resizing Plan.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"sbrDatabaseName": {
"description": "The SBR Database to be resized.",
"type": "string"
},
"targetNumOfServerGroups": {
"description": "The total number of Policy SBR Server Groups required to support the migrated or resized database.Enter the total number of Server Groups necessary to support the capacity of the resized database, including any server groups that will be reused from the original resource domain.",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"targetResourceDomainName": {
"description": "The Resource Domain into which the database is to be migrated.Select the Resource Domain that will host the resized database.",
"type": "string"
}
},
"required": [
"planName",
"sbrDatabaseName",
"targetNumOfServerGroups",
"targetResourceDomainName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"databaseType": "Usbr",
"initialNumOfServerGroups": 1,
"initialResourceDomainName": "secondresourcedomainname",
"planName": "MySBRDatabaseResizingPlan",
"sbrDatabaseName": "NEWSBRDATABASENAME",
"targetNumOfServerGroups": 1,
"targetResourceDomainName": "FourthResourceDomain"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /sbr/databaseresizingplans
Each database is to be resized by migrating records from the Initial Resource Domain to the Target Resource Domain. Creation of an SBR Database Resizing Plan has no effect on the running database. The new SBR Database Resizing Plans must have a name that is unique across all Database Resizing Plans list at the NOAM.To create one database resizing plan we need to configure server from /topo/servers, server group from /topo/servergroups, resource domain from /topo/resourcedomains, Places from /topo/places, Place Association from /topo/placeassociations and sbr database from sbr/sbrDatabases and finally enble the database to make it available in creating Database Resizing Plan.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/databaseresizingplan/databaseresizingplan.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"type": "string",
"readOnly": true
},
"initialNumOfServerGroups": {
"description": "The number of Server Groups hosting this database.",
"type": "integer",
"readOnly": true
},
"initialResourceDomainName": {
"description": "The Resource Domain configured for the selected database.",
"type": "string",
"readOnly": true
},
"planName": {
"description": "A name that uniquely identifies the SBR Database Resizing Plan.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"sbrDatabaseName": {
"description": "The SBR Database to be resized.",
"type": "string"
},
"targetNumOfServerGroups": {
"description": "The total number of Policy SBR Server Groups required to support the migrated or resized database.Enter the total number of Server Groups necessary to support the capacity of the resized database, including any server groups that will be reused from the original resource domain.",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"targetResourceDomainName": {
"description": "The Resource Domain into which the database is to be migrated.Select the Resource Domain that will host the resized database.",
"type": "string"
}
},
"required": [
"planName",
"sbrDatabaseName",
"targetNumOfServerGroups",
"targetResourceDomainName"
],
"type": "object"
}
Example
{
"databaseType": "Usbr",
"initialNumOfServerGroups": 1,
"initialResourceDomainName": "secondresourcedomainname",
"planName": "MySBRDatabaseResizingPlan",
"sbrDatabaseName": "NEWSBRDATABASENAME",
"targetNumOfServerGroups": 1,
"targetResourceDomainName": "FourthResourceDomain"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/sbr/databaseresizingplans/{name}
get /sbr/databaseresizingplans/{name}
Returns the configuration details for the specified Database Resizing Plan List. If the specified Database Resizing Plan List does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/items/databaseresizingplanItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/databaseresizingplan/databaseresizingplan.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"type": "string",
"readOnly": true
},
"initialNumOfServerGroups": {
"description": "The number of Server Groups hosting this database.",
"type": "integer",
"readOnly": true
},
"initialResourceDomainName": {
"description": "The Resource Domain configured for the selected database.",
"type": "string",
"readOnly": true
},
"planName": {
"description": "A name that uniquely identifies the SBR Database Resizing Plan.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"sbrDatabaseName": {
"description": "The SBR Database to be resized.",
"type": "string"
},
"targetNumOfServerGroups": {
"description": "The total number of Policy SBR Server Groups required to support the migrated or resized database.Enter the total number of Server Groups necessary to support the capacity of the resized database, including any server groups that will be reused from the original resource domain.",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"targetResourceDomainName": {
"description": "The Resource Domain into which the database is to be migrated.Select the Resource Domain that will host the resized database.",
"type": "string"
}
},
"required": [
"planName",
"sbrDatabaseName",
"targetNumOfServerGroups",
"targetResourceDomainName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"databaseType": "Usbr",
"initialNumOfServerGroups": 1,
"initialResourceDomainName": "secondresourcedomainname",
"planName": "MySBRDatabaseResizingPlan",
"sbrDatabaseName": "NEWSBRDATABASENAME",
"targetNumOfServerGroups": 1,
"targetResourceDomainName": "FourthResourceDomain"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /sbr/databaseresizingplans/{name}
Updates the configuration for the specified Database Resizing Plan List. If the provided Database Resizing Plan List data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/databaseresizingplan/databaseresizingplan.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"type": "string",
"readOnly": true
},
"initialNumOfServerGroups": {
"description": "The number of Server Groups hosting this database.",
"type": "integer",
"readOnly": true
},
"initialResourceDomainName": {
"description": "The Resource Domain configured for the selected database.",
"type": "string",
"readOnly": true
},
"planName": {
"description": "A name that uniquely identifies the SBR Database Resizing Plan.",
"maxLength": 32,
"minLength": 1,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"sbrDatabaseName": {
"description": "The SBR Database to be resized.",
"type": "string"
},
"targetNumOfServerGroups": {
"description": "The total number of Policy SBR Server Groups required to support the migrated or resized database.Enter the total number of Server Groups necessary to support the capacity of the resized database, including any server groups that will be reused from the original resource domain.",
"maximum": 8,
"minimum": 1,
"type": "integer"
},
"targetResourceDomainName": {
"description": "The Resource Domain into which the database is to be migrated.Select the Resource Domain that will host the resized database.",
"type": "string"
}
},
"required": [
"planName",
"sbrDatabaseName",
"targetNumOfServerGroups",
"targetResourceDomainName"
],
"type": "object"
}
Example
{
"databaseType": "Usbr",
"initialNumOfServerGroups": 1,
"initialResourceDomainName": "secondresourcedomainname",
"planName": "MySBRDatabaseResizingPlan",
"sbrDatabaseName": "NEWSBRDATABASENAME",
"targetNumOfServerGroups": 1,
"targetResourceDomainName": "FourthResourceDomain"
}
delete /sbr/databaseresizingplans/{name}
Deletes the specified Database Resizing Plan List from the NOAM configuration. After creating a Resizing Plan, change SBR Database Reconfiguration Status screen to prepare, start and monitor the migration. Once migration has completed, or has been cancelled, the SBR Database Resizing Plan should be deleted.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Sbr: Data Migration Plan
SBR Data Migration Plan is the process of moving data from an Initial Database to the Target Database by creating new records in the target and allowing records in the initial to be removed by normal PCA Diameter signaling.
All Data Migration configuration is done at the NOAM.
/sbr/datamigrationplans
get /sbr/datamigrationplans
Returns all Data Migration Plan configured at the NOAM that meet the criteria specified in a valid GET request. If valid parameters are provided in the request, only those Data Migration Plan meeting the request parameters are returned in the response. If parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/collections/datamigrationplanCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/datamigrationplan/datamigrationplan.json",
"properties": {
"initDatabase": {
"description": "The name that uniquely identifies the database from which records are to be migrated.",
"type": "string"
},
"initPlaceAssociation": {
"description": "The Place Association configured to use the Initial Database. This read only field displays the Place Association configured for the Initial Database.",
"readOnly": true,
"type": "string"
},
"migrationType": {
"description": "The type of data migration plan that this plan is to be a part of.",
"enum": [
"Mating",
"ReMating",
"UnMating"
],
"type": "string"
},
"planName": {
"description": "The name that uniquely identifies the SBR Data Migration Plan.",
"maxLength": 32,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"targetDatabase": {
"description": "A name that uniquely identifies the database to which records are to be migrated.",
"type": "string"
},
"targetPlaceAssociation": {
"description": "The Place Association configured to use the Target Database. This read only field displays the Place Association configured for the Target Database.",
"readOnly": true,
"type": "string"
}
},
"required": [
"initDatabase",
"migrationType",
"planName",
"targetDatabase"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"initDatabase": "SCEF_ContextData",
"initPlaceAssociation": "SBR_Association",
"migrationType": "ReMating",
"planName": "SBRDataMigrationPlan",
"targetDatabase": "SBRDATA2",
"targetPlaceAssociation": "trial"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
post /sbr/datamigrationplans
Adds a new Data Migration Plan to the DSR configuration. The new Data Migration Plan must have a name that is unique across all Database list at the NOAM. Creation of an SBR Data Migration Plan has no effect on either database. After creating a Data Migration Plan, go to the SBR Database Reconfiguration Status screen to prepare, start and monitor the migration. Once migration has completed, or has been cancelled, the SBR Data Migration Plan should be deleted.
Target Server: NOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/datamigrationplan/datamigrationplan.json",
"properties": {
"initDatabase": {
"description": "The name that uniquely identifies the database from which records are to be migrated.",
"type": "string"
},
"initPlaceAssociation": {
"description": "The Place Association configured to use the Initial Database. This read only field displays the Place Association configured for the Initial Database.",
"readOnly": true,
"type": "string"
},
"migrationType": {
"description": "The type of data migration plan that this plan is to be a part of.",
"enum": [
"Mating",
"ReMating",
"UnMating"
],
"type": "string"
},
"planName": {
"description": "The name that uniquely identifies the SBR Data Migration Plan.",
"maxLength": 32,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"targetDatabase": {
"description": "A name that uniquely identifies the database to which records are to be migrated.",
"type": "string"
},
"targetPlaceAssociation": {
"description": "The Place Association configured to use the Target Database. This read only field displays the Place Association configured for the Target Database.",
"readOnly": true,
"type": "string"
}
},
"required": [
"initDatabase",
"migrationType",
"planName",
"targetDatabase"
],
"type": "object"
}
Example
{
"initDatabase": "SCEF_ContextData",
"initPlaceAssociation": "SBR_Association",
"migrationType": "ReMating",
"planName": "SBRDataMigrationPlan",
"targetDatabase": "SBRDATA2",
"targetPlaceAssociation": "trial"
}
Response
HTTP status code 201
/sbr/datamigrationplans/{name}
get /sbr/datamigrationplans/{name}
Returns the configuration details for the specified Database List. If the specified Database List does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/items/datamigrationplanItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/datamigrationplan/datamigrationplan.json",
"properties": {
"initDatabase": {
"description": "The name that uniquely identifies the database from which records are to be migrated.",
"type": "string"
},
"initPlaceAssociation": {
"description": "The Place Association configured to use the Initial Database. This read only field displays the Place Association configured for the Initial Database.",
"readOnly": true,
"type": "string"
},
"migrationType": {
"description": "The type of data migration plan that this plan is to be a part of.",
"enum": [
"Mating",
"ReMating",
"UnMating"
],
"type": "string"
},
"planName": {
"description": "The name that uniquely identifies the SBR Data Migration Plan.",
"maxLength": 32,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
},
"targetDatabase": {
"description": "A name that uniquely identifies the database to which records are to be migrated.",
"type": "string"
},
"targetPlaceAssociation": {
"description": "The Place Association configured to use the Target Database. This read only field displays the Place Association configured for the Target Database.",
"readOnly": true,
"type": "string"
}
},
"required": [
"initDatabase",
"migrationType",
"planName",
"targetDatabase"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"initDatabase": "SCEF_ContextData",
"initPlaceAssociation": "SBR_Association",
"migrationType": "ReMating",
"planName": "SBRDataMigrationPlan",
"targetDatabase": "SBRDATA2",
"targetPlaceAssociation": "trial"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /sbr/datamigrationplans/{name}
Deletes the specified Data Migration Plan from the NOAM configuration. A Data Migration Plan can only be deleted if all delete validation checks pass. An attempt to delete Database List that cannot be deleted results in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Sbr: Databases
Sbr Databases configures all the databases required with respect to SBR.
All Database configuration is done at the NOAM.
/sbr/sbrdatabases
get /sbr/sbrdatabases
Returns all Databases configured at the NOAM that meet the criteria specified in a valid GET request. If valid parameters are provided in the request, only those Databases meeting the request parameters are returned in the response. If parameters are not provided in the request, the DSR applies default paging (as described in the General Behaviors section).
Target Server: NOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/collections/sbrdatabaseCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/sbrdatabase/sbrdatabase.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"enum": [
"Binding",
"Session",
"Usbr"
],
"type": "string"
},
"ownerAppName": {
"description": "The name of application that owns the configured SBR DB. Owner Application name is the name of DCA application that is already configured ,if the Database Type is Universal. Otherwise if the Owner Application is empty it will be either none or 'PCA'.",
"type": "string"
},
"placeAssociationName": {
"description": "The Place Association that contains the Places (Sites) that will use this database. Valid values are only those place associations that are configured.",
"type": "string"
},
"resourceDomainName": {
"description": "The Resource Domain that contains the SBR Server Groups configured for use by this database.Valid values are only those resource domain that are configured.",
"type": "string"
},
"numberOfServerGroups": {
"description": "The number of SBR Server Groups required to host this database. Enter or change the number of Server Groups necessary to support the desired capacity of the database. If the selected Resource Domain already contains Server Groups, the number of Server Groups in the Resource Domain is displayed in the field, but can be overridden as desired.Range of 1 to 8 for a Binding or Session DB, 1 to 64 for a Universal DB",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"sbrDatabaseName": {
"description": "A name that uniquely identifies the SBR Database.",
"maxLength": 32,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
}
},
"required": [
"databaseType",
"placeAssociationName",
"resourceDomainName",
"numberOfServerGroups",
"sbrDatabaseName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"databaseType": "Usbr",
"numberOfServerGroups": 5,
"ownerAppName": "SCEF",
"placeAssociationName": "trial",
"resourceDomainName": "new",
"sbrDatabaseName": "SBRDATA2"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /sbr/sbrdatabases
Adds a new Database to the DSR configuration. The new Database must have a name that is unique across all Database list at the NOAM.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/sbrdatabase/sbrdatabase.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"enum": [
"Binding",
"Session",
"Usbr"
],
"type": "string"
},
"ownerAppName": {
"description": "The name of application that owns the configured SBR DB. Owner Application name is the name of DCA application that is already configured ,if the Database Type is Universal. Otherwise if the Owner Application is empty it will be either none or 'PCA'.",
"type": "string"
},
"placeAssociationName": {
"description": "The Place Association that contains the Places (Sites) that will use this database. Valid values are only those place associations that are configured.",
"type": "string"
},
"resourceDomainName": {
"description": "The Resource Domain that contains the SBR Server Groups configured for use by this database.Valid values are only those resource domain that are configured.",
"type": "string"
},
"numberOfServerGroups": {
"description": "The number of SBR Server Groups required to host this database. Enter or change the number of Server Groups necessary to support the desired capacity of the database. If the selected Resource Domain already contains Server Groups, the number of Server Groups in the Resource Domain is displayed in the field, but can be overridden as desired.Range of 1 to 8 for a Binding or Session DB, 1 to 64 for a Universal DB",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"sbrDatabaseName": {
"description": "A name that uniquely identifies the SBR Database.",
"maxLength": 32,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
}
},
"required": [
"databaseType",
"placeAssociationName",
"resourceDomainName",
"numberOfServerGroups",
"sbrDatabaseName"
],
"type": "object"
}
Example
{
"databaseType": "Usbr",
"numberOfServerGroups": 5,
"ownerAppName": "SCEF",
"placeAssociationName": "trial",
"resourceDomainName": "new",
"sbrDatabaseName": "SBRDATA2"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/sbr/sbrdatabases/{name}
get /sbr/sbrdatabases/{name}
Returns the configuration details for the specified Database List. If the specified Database List does not exist in the NOAM's configuration, an error message is returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/items/sbrdatabaseItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/sbrdatabase/sbrdatabase.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"enum": [
"Binding",
"Session",
"Usbr"
],
"type": "string"
},
"ownerAppName": {
"description": "The name of application that owns the configured SBR DB. Owner Application name is the name of DCA application that is already configured ,if the Database Type is Universal. Otherwise if the Owner Application is empty it will be either none or 'PCA'.",
"type": "string"
},
"placeAssociationName": {
"description": "The Place Association that contains the Places (Sites) that will use this database. Valid values are only those place associations that are configured.",
"type": "string"
},
"resourceDomainName": {
"description": "The Resource Domain that contains the SBR Server Groups configured for use by this database.Valid values are only those resource domain that are configured.",
"type": "string"
},
"numberOfServerGroups": {
"description": "The number of SBR Server Groups required to host this database. Enter or change the number of Server Groups necessary to support the desired capacity of the database. If the selected Resource Domain already contains Server Groups, the number of Server Groups in the Resource Domain is displayed in the field, but can be overridden as desired.Range of 1 to 8 for a Binding or Session DB, 1 to 64 for a Universal DB",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"sbrDatabaseName": {
"description": "A name that uniquely identifies the SBR Database.",
"maxLength": 32,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
}
},
"required": [
"databaseType",
"placeAssociationName",
"resourceDomainName",
"numberOfServerGroups",
"sbrDatabaseName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"databaseType": "Usbr",
"numberOfServerGroups": 5,
"ownerAppName": "SCEF",
"placeAssociationName": "trial",
"resourceDomainName": "new",
"sbrDatabaseName": "SBRDATA2"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /sbr/sbrdatabases/{name}
Updates the configuration for the specified Database List. If the provided Database List data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/sbr/sbrdatabase/sbrdatabase.json",
"properties": {
"databaseType": {
"description": "The type of SBR Database.",
"enum": [
"Binding",
"Session",
"Usbr"
],
"type": "string"
},
"ownerAppName": {
"description": "The name of application that owns the configured SBR DB. Owner Application name is the name of DCA application that is already configured ,if the Database Type is Universal. Otherwise if the Owner Application is empty it will be either none or 'PCA'.",
"type": "string"
},
"placeAssociationName": {
"description": "The Place Association that contains the Places (Sites) that will use this database. Valid values are only those place associations that are configured.",
"type": "string"
},
"resourceDomainName": {
"description": "The Resource Domain that contains the SBR Server Groups configured for use by this database.Valid values are only those resource domain that are configured.",
"type": "string"
},
"numberOfServerGroups": {
"description": "The number of SBR Server Groups required to host this database. Enter or change the number of Server Groups necessary to support the desired capacity of the database. If the selected Resource Domain already contains Server Groups, the number of Server Groups in the Resource Domain is displayed in the field, but can be overridden as desired.Range of 1 to 8 for a Binding or Session DB, 1 to 64 for a Universal DB",
"maximum": 64,
"minimum": 1,
"type": "integer"
},
"sbrDatabaseName": {
"description": "A name that uniquely identifies the SBR Database.",
"maxLength": 32,
"pattern": "^[A-Za-z][A-Za-z0-9]*",
"type": "string"
}
},
"required": [
"databaseType",
"placeAssociationName",
"resourceDomainName",
"numberOfServerGroups",
"sbrDatabaseName"
],
"type": "object"
}
Example
{
"databaseType": "Usbr",
"numberOfServerGroups": 5,
"ownerAppName": "SCEF",
"placeAssociationName": "trial",
"resourceDomainName": "new",
"sbrDatabaseName": "SBRDATA2"
}
delete /sbr/sbrdatabases/{name}
Deletes the specified Database List from the NOAM configuration. A Database List can only be deleted if all delete validation checks pass. An attempt to delete Database List that cannot be deleted results in an error message returned within the HTTP response.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Access Control Association
An Access Control Association (ACA) configuration allows user to associate Access Control Rule (ACR) with Access Control List (ACL).
All configuration of the ACA is done at the SOAM.
/scef/accesscontrolassociations
get /scef/accesscontrolassociations
Returns all ACA configurations that meet the criteria specified in the GET request. By default, all ACAs configured at the SOAM are returned. If paging parameters are supplied, only those ACA configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/accesscontrolassociationCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrolassociation/accesscontrolassociation.json",
"properties": {
"aclName": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"ruleName": {
"description": "The name of the Access Control Rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
}
},
"required": [
"aclName",
"ruleName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"aclName": "ACL1",
"ruleName": "RULE1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/accesscontrolassociations
Adds a new ACA to the SCEF configuration. The ACA configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrolassociation/accesscontrolassociation.json",
"properties": {
"aclName": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"ruleName": {
"description": "The name of the Access Control Rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
}
},
"required": [
"aclName",
"ruleName"
],
"type": "object"
}
Example
{
"aclName": "ACL1",
"ruleName": "RULE1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/accesscontrolassociations/{name}
get /scef/accesscontrolassociations/{name}
Returns the configuration details for the specified ACA. If the ACA does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/accesscontrolassociationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrolassociation/accesscontrolassociation.json",
"properties": {
"aclName": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"ruleName": {
"description": "The name of the Access Control Rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
}
},
"required": [
"aclName",
"ruleName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"aclName": "ACL1",
"ruleName": "RULE1"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/accesscontrolassociations/{name}
delete /scef/accesscontrolassociations/{name}
Deletes the specified ACA from the SOAM configuration. User has to provide both the ACL name and ACR name separated by a colon (:) to delete an ACA entry. The identifier for delete operation would become
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Access Control List
An Access Control List (ACL) configuration entry consists of a name. Purpose of ACL is to maintain set of Access Control Rules that can be associated to one or more SCS/AS.
All configuration of the ACL is done at the SOAM.
/scef/accesscontrollists
get /scef/accesscontrollists
Returns all ACL configurations that meet the criteria specified in the GET request. By default, all ACLs configured at the SOAM are returned. If paging parameters are supplied, only those ACL configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/accesscontrollistCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrollist/accesscontrollist.json",
"properties": {
"name": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "ACL1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/accesscontrollists
Adds a new ACL to the SCEF configuration. The ACL configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrollist/accesscontrollist.json",
"properties": {
"name": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "ACL1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/accesscontrollists/{name}
get /scef/accesscontrollists/{name}
Returns the configuration details for the specified ACL. If the ACL does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/accesscontrollistItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrollist/accesscontrollist.json",
"properties": {
"name": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "ACL1"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/accesscontrollists/{name}
delete /scef/accesscontrollists/{name}
Deletes the specified ACL from the SOAM configuration. An attempt to delete a ACL which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Access Control Rules
An Access Control Rule (ACR) configuration entry consists of a name of the rule and rule-specific data like MSISDN range, domain, feature list [NIDD/Device Triggering/Monitoring Event]. It allows user to configure MSISDN or External Identifier domain.
All configuration of the ACR is done at the SOAM.
/scef/accesscontrolrules
get /scef/accesscontrolrules
Returns all ACR configurations that meet the criteria specified in the GET request. By default, all ACRs configured at the SOAM are returned. If paging parameters are supplied, only those ACR configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/accesscontrolruleCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrolrule/accesscontrolrule.json",
"properties": {
"domain": {
"description": "This is to identify the UE's domain.",
"maxLength": 128,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"endAddr": {
"description": "End Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"name": {
"description": "The name of the Access Control Rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"startAddr": {
"description": "Start Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"supportedFeatures": {
"description": "List of MTC features to be supported for this rule.",
"items": {
"enum": [
"ECR",
"Monitoring",
"Nidd",
"Triggering"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"userIdentifierType": {
"description": "Type of address to identify the UE.",
"enum": [
"MSISDN",
"DOMAIN"
],
"type": "string"
}
},
"required": [
"name",
"userIdentifierType",
"supportedFeatures"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"endAddr": "233456789",
"name": "RULE1",
"startAddr": "123456789",
"supportedFeatures": [
"Monitoring",
"Nidd"
],
"userIdentifierType": "MSISDN"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/accesscontrolrules
Adds a new ACR to the SCEF configuration. The ACR configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrolrule/accesscontrolrule.json",
"properties": {
"domain": {
"description": "This is to identify the UE's domain.",
"maxLength": 128,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"endAddr": {
"description": "End Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"name": {
"description": "The name of the Access Control Rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"startAddr": {
"description": "Start Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"supportedFeatures": {
"description": "List of MTC features to be supported for this rule.",
"items": {
"enum": [
"ECR",
"Monitoring",
"Nidd",
"Triggering"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"userIdentifierType": {
"description": "Type of address to identify the UE.",
"enum": [
"MSISDN",
"DOMAIN"
],
"type": "string"
}
},
"required": [
"name",
"userIdentifierType",
"supportedFeatures"
],
"type": "object"
}
Example
{
"endAddr": "233456789",
"name": "RULE1",
"startAddr": "123456789",
"supportedFeatures": [
"Monitoring",
"Nidd"
],
"userIdentifierType": "MSISDN"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/accesscontrolrules/{name}
get /scef/accesscontrolrules/{name}
Returns the configuration details for the specified ACR. If the ACR does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/accesscontrolruleItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrolrule/accesscontrolrule.json",
"properties": {
"domain": {
"description": "This is to identify the UE's domain.",
"maxLength": 128,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"endAddr": {
"description": "End Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"name": {
"description": "The name of the Access Control Rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"startAddr": {
"description": "Start Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"supportedFeatures": {
"description": "List of MTC features to be supported for this rule.",
"items": {
"enum": [
"ECR",
"Monitoring",
"Nidd",
"Triggering"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"userIdentifierType": {
"description": "Type of address to identify the UE.",
"enum": [
"MSISDN",
"DOMAIN"
],
"type": "string"
}
},
"required": [
"name",
"userIdentifierType",
"supportedFeatures"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"endAddr": "233456789",
"name": "RULE1",
"startAddr": "123456789",
"supportedFeatures": [
"Monitoring",
"Nidd"
],
"userIdentifierType": "MSISDN"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/accesscontrolrules/{name}
It only updates the Feature List of the specified ACR and all other attributes are not editable. If the provided ACR data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/accesscontrolrule/accesscontrolrule.json",
"properties": {
"domain": {
"description": "This is to identify the UE's domain.",
"maxLength": 128,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"endAddr": {
"description": "End Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"name": {
"description": "The name of the Access Control Rule.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"startAddr": {
"description": "Start Address of the MSISDN range.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"supportedFeatures": {
"description": "List of MTC features to be supported for this rule.",
"items": {
"enum": [
"ECR",
"Monitoring",
"Nidd",
"Triggering"
],
"type": "string"
},
"maxItems": 4,
"minItems": 1,
"type": "array"
},
"userIdentifierType": {
"description": "Type of address to identify the UE.",
"enum": [
"MSISDN",
"DOMAIN"
],
"type": "string"
}
},
"required": [
"name",
"userIdentifierType",
"supportedFeatures"
],
"type": "object"
}
Example
{
"endAddr": "233456789",
"name": "RULE1",
"startAddr": "123456789",
"supportedFeatures": [
"Monitoring",
"Nidd"
],
"userIdentifierType": "MSISDN"
}
delete /scef/accesscontrolrules/{name}
Deletes the specified ACR from the SOAM configuration. An attempt to delete a ACR which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: APN Configuration
An APN configuration entry consists of a name and configuration-specific data.
All configuration of the APN is done at the SOAM.
/scef/apnconfigurationsets
get /scef/apnconfigurationsets
Returns all APN configurations that meet the criteria specified in the GET request. By default, all APNs configured at the SOAM are returned. If paging parameters are supplied, only those APN configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/apnconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/apnconfigurationset/apnconfigurationset.json",
"properties": {
"downlinkApnMessageRate": {
"description": "Downlink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"downlinkApnRateControlUnit": {
"description": "Downlink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"downlinkApnRateControlVal": {
"description": "Downlink APN rate control value. Range is 1 to 59 when downlinkApnRateControlUnit is set to Minute, Range is 1 to 23 when downlinkApnRateControlUnit is set to Hour, Range is 1 to 6 when downlinkApnRateControlUnit is set to Day, Range is 1 to 52 when downlinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"maxPacketBufferSize": {
"description": "Maximum packet size in bytes that is allowed to be buffered for this APN.",
"maximum": 1500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"maxPacketSize": {
"description": "Maximum packet size in bytes allowed for this APN.",
"maximum": 2500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"name": {
"description": "Access Point Name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"uplinkApnMessageRate": {
"description": "Uplink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"uplinkApnRateControlUnit": {
"description": "Uplink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"uplinkApnRateControlVal": {
"description": "Uplink APN rate control value. Range is 1 to 59 when uplinkApnRateControlUnit is set to Minute, Range is 1 to 23 when uplinkApnRateControlUnit is set to Hour, Range is 1 to 6 when uplinkApnRateControlUnit is set to Day, Range is 1 to 52 when uplinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"value": {
"description": "Access Point Value.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"downlinkApnMessageRate": 300,
"downlinkApnRateControlUnit": "Day",
"downlinkApnRateControlVal": 3,
"maxPacketBufferSize": 100,
"maxPacketSize": 100,
"name": "apn1.test.com",
"value": "apn1.test.com",
"uplinkApnMessageRate": 600,
"uplinkApnRateControlUnit": "Week",
"uplinkApnRateControlVal": 6
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/apnconfigurationsets
Adds a new APN to the SCEF configuration. The APN configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/apnconfigurationset/apnconfigurationset.json",
"properties": {
"downlinkApnMessageRate": {
"description": "Downlink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"downlinkApnRateControlUnit": {
"description": "Downlink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"downlinkApnRateControlVal": {
"description": "Downlink APN rate control value. Range is 1 to 59 when downlinkApnRateControlUnit is set to Minute, Range is 1 to 23 when downlinkApnRateControlUnit is set to Hour, Range is 1 to 6 when downlinkApnRateControlUnit is set to Day, Range is 1 to 52 when downlinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"maxPacketBufferSize": {
"description": "Maximum packet size in bytes that is allowed to be buffered for this APN.",
"maximum": 1500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"maxPacketSize": {
"description": "Maximum packet size in bytes allowed for this APN.",
"maximum": 2500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"name": {
"description": "Access Point Name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"uplinkApnMessageRate": {
"description": "Uplink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"uplinkApnRateControlUnit": {
"description": "Uplink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"uplinkApnRateControlVal": {
"description": "Uplink APN rate control value. Range is 1 to 59 when uplinkApnRateControlUnit is set to Minute, Range is 1 to 23 when uplinkApnRateControlUnit is set to Hour, Range is 1 to 6 when uplinkApnRateControlUnit is set to Day, Range is 1 to 52 when uplinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"value": {
"description": "Access Point Value.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
}
Example
{
"downlinkApnMessageRate": 300,
"downlinkApnRateControlUnit": "Day",
"downlinkApnRateControlVal": 3,
"maxPacketBufferSize": 100,
"maxPacketSize": 100,
"name": "apn1.test.com",
"value": "apn1.test.com",
"uplinkApnMessageRate": 600,
"uplinkApnRateControlUnit": "Week",
"uplinkApnRateControlVal": 6
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/apnconfigurationsets/{name}
get /scef/apnconfigurationsets/{name}
Returns the configuration details for the specified APN. If the APN does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/apnconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/apnconfigurationset/apnconfigurationset.json",
"properties": {
"downlinkApnMessageRate": {
"description": "Downlink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"downlinkApnRateControlUnit": {
"description": "Downlink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"downlinkApnRateControlVal": {
"description": "Downlink APN rate control value. Range is 1 to 59 when downlinkApnRateControlUnit is set to Minute, Range is 1 to 23 when downlinkApnRateControlUnit is set to Hour, Range is 1 to 6 when downlinkApnRateControlUnit is set to Day, Range is 1 to 52 when downlinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"maxPacketBufferSize": {
"description": "Maximum packet size in bytes that is allowed to be buffered for this APN.",
"maximum": 1500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"maxPacketSize": {
"description": "Maximum packet size in bytes allowed for this APN.",
"maximum": 2500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"name": {
"description": "Access Point Name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"uplinkApnMessageRate": {
"description": "Uplink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"uplinkApnRateControlUnit": {
"description": "Uplink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"uplinkApnRateControlVal": {
"description": "Uplink APN rate control value. Range is 1 to 59 when uplinkApnRateControlUnit is set to Minute, Range is 1 to 23 when uplinkApnRateControlUnit is set to Hour, Range is 1 to 6 when uplinkApnRateControlUnit is set to Day, Range is 1 to 52 when uplinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"value": {
"description": "Access Point Value.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"downlinkApnMessageRate": 300,
"downlinkApnRateControlUnit": "Day",
"downlinkApnRateControlVal": 3,
"maxPacketBufferSize": 100,
"maxPacketSize": 100,
"name": "apn1.test.com",
"value": "apn1.test.com",
"uplinkApnMessageRate": 600,
"uplinkApnRateControlUnit": "Week",
"uplinkApnRateControlVal": 6
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/apnconfigurationsets/{name}
Updates the configuration of the specified APN. If the provided APN data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/apnconfigurationset/apnconfigurationset.json",
"properties": {
"downlinkApnMessageRate": {
"description": "Downlink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"downlinkApnRateControlUnit": {
"description": "Downlink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"downlinkApnRateControlVal": {
"description": "Downlink APN rate control value. Range is 1 to 59 when downlinkApnRateControlUnit is set to Minute, Range is 1 to 23 when downlinkApnRateControlUnit is set to Hour, Range is 1 to 6 when downlinkApnRateControlUnit is set to Day, Range is 1 to 52 when downlinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"maxPacketBufferSize": {
"description": "Maximum packet size in bytes that is allowed to be buffered for this APN.",
"maximum": 1500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"maxPacketSize": {
"description": "Maximum packet size in bytes allowed for this APN.",
"maximum": 2500,
"minimum": 1,
"default": 100,
"type": "integer"
},
"name": {
"description": "Access Point Name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"uplinkApnMessageRate": {
"description": "Uplink APN message rate.",
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"uplinkApnRateControlUnit": {
"description": "Uplink APN rate control unit.",
"enum": [
"Unrestricted",
"Minute",
"Hour",
"Day",
"Week"
],
"default": "Unrestricted",
"type": "string"
},
"uplinkApnRateControlVal": {
"description": "Uplink APN rate control value. Range is 1 to 59 when uplinkApnRateControlUnit is set to Minute, Range is 1 to 23 when uplinkApnRateControlUnit is set to Hour, Range is 1 to 6 when uplinkApnRateControlUnit is set to Day, Range is 1 to 52 when uplinkApnRateControlUnit is set to Week",
"maximum": 59,
"minimum": 1,
"type": "integer"
},
"value": {
"description": "Access Point Value.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
}
},
"required": [
"name",
"value"
],
"type": "object"
}
Example
{
"downlinkApnMessageRate": 300,
"downlinkApnRateControlUnit": "Day",
"downlinkApnRateControlVal": 3,
"maxPacketBufferSize": 100,
"maxPacketSize": 100,
"name": "apn1.test.com",
"value": "apn1.test.com",
"uplinkApnMessageRate": 600,
"uplinkApnRateControlUnit": "Week",
"uplinkApnRateControlVal": 6
}
delete /scef/apnconfigurationsets/{name}
Deletes the specified APN from the SOAM configuration. An attempt to delete an APN which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Device Triggering Configuration
A Device Triggering configuration entry consists of a name and configuration-specific data which is used to configure a SCS/AS.
All configuration of the Device Triggering is done at the SOAM.
/scef/devicetriggeringconfigurationsets
get /scef/devicetriggeringconfigurationsets
Returns all Device Triggering configurations that meet the criteria specified in the GET request. By default, all Device Triggerings configured at the SOAM are returned. If paging parameters are supplied, only those Device Triggering configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/devicetriggeringconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/devicetriggeringconfigurationset/devicetriggeringconfigurationset.json",
"properties": {
"defaultApplicationPort": {
"description": "When mandateApplicationPort is set to true, value of this parameter will be used (if not provided by T8) to set 'Application-Port-Identifier' AVP in SIR and DTR.",
"maximum": 65535,
"minimum": 0,
"default": 1000,
"type": "integer"
},
"defaultPriority": {
"description": "When mandatePriority is set to true, value of this parameter will be used (if not provided by T8) to populate 'Priority-Indication' AVP in SIR and DTR.",
"enum": [
"NonPriority",
"Priority"
],
"default": "NonPriority",
"type": "string"
},
"maxValidityPeriod": {
"description": "Maximum allowed validity period in seconds. The value -1 indicates no check of validity period will be performed by SCEF/MTC-IWF.",
"maximum": 86400,
"minimum": -1,
"default": 3600,
"type": "integer"
},
"name": {
"description": "The name of the Device Triggering configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"mandateApplicationPort": {
"description": "This indicates whether to enforce SCS/AS provided application port or not. When set to false, then SCS/AS provided application port (if available) will be enforced. When set to true, MTC-IWF will always set 'Application-Port-Identifier' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
},
"mandatePriority": {
"description": "This indicates whether to enforce SCS/AS provided priority or not. When set to false, then SCS/AS provided priority (if available) will be enforced. When set to true, MTC-IWF will always set the 'Priority-Indication' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"defaultApplicationPort": 1000,
"defaultPriority": "NonPriority",
"maxValidityPeriod": 3600,
"name": "DevTrig1",
"mandateApplicationPort": false,
"mandatePriority": false
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/devicetriggeringconfigurationsets
Adds a new Device Triggering to the SCEF configuration. The Device Triggering configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/devicetriggeringconfigurationset/devicetriggeringconfigurationset.json",
"properties": {
"defaultApplicationPort": {
"description": "When mandateApplicationPort is set to true, value of this parameter will be used (if not provided by T8) to set 'Application-Port-Identifier' AVP in SIR and DTR.",
"maximum": 65535,
"minimum": 0,
"default": 1000,
"type": "integer"
},
"defaultPriority": {
"description": "When mandatePriority is set to true, value of this parameter will be used (if not provided by T8) to populate 'Priority-Indication' AVP in SIR and DTR.",
"enum": [
"NonPriority",
"Priority"
],
"default": "NonPriority",
"type": "string"
},
"maxValidityPeriod": {
"description": "Maximum allowed validity period in seconds. The value -1 indicates no check of validity period will be performed by SCEF/MTC-IWF.",
"maximum": 86400,
"minimum": -1,
"default": 3600,
"type": "integer"
},
"name": {
"description": "The name of the Device Triggering configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"mandateApplicationPort": {
"description": "This indicates whether to enforce SCS/AS provided application port or not. When set to false, then SCS/AS provided application port (if available) will be enforced. When set to true, MTC-IWF will always set 'Application-Port-Identifier' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
},
"mandatePriority": {
"description": "This indicates whether to enforce SCS/AS provided priority or not. When set to false, then SCS/AS provided priority (if available) will be enforced. When set to true, MTC-IWF will always set the 'Priority-Indication' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"defaultApplicationPort": 1000,
"defaultPriority": "NonPriority",
"maxValidityPeriod": 3600,
"name": "DevTrig1",
"mandateApplicationPort": false,
"mandatePriority": false
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/devicetriggeringconfigurationsets/{name}
get /scef/devicetriggeringconfigurationsets/{name}
Returns the configuration details for the specified Device Triggering. If the Device Triggering does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/devicetriggeringconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/devicetriggeringconfigurationset/devicetriggeringconfigurationset.json",
"properties": {
"defaultApplicationPort": {
"description": "When mandateApplicationPort is set to true, value of this parameter will be used (if not provided by T8) to set 'Application-Port-Identifier' AVP in SIR and DTR.",
"maximum": 65535,
"minimum": 0,
"default": 1000,
"type": "integer"
},
"defaultPriority": {
"description": "When mandatePriority is set to true, value of this parameter will be used (if not provided by T8) to populate 'Priority-Indication' AVP in SIR and DTR.",
"enum": [
"NonPriority",
"Priority"
],
"default": "NonPriority",
"type": "string"
},
"maxValidityPeriod": {
"description": "Maximum allowed validity period in seconds. The value -1 indicates no check of validity period will be performed by SCEF/MTC-IWF.",
"maximum": 86400,
"minimum": -1,
"default": 3600,
"type": "integer"
},
"name": {
"description": "The name of the Device Triggering configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"mandateApplicationPort": {
"description": "This indicates whether to enforce SCS/AS provided application port or not. When set to false, then SCS/AS provided application port (if available) will be enforced. When set to true, MTC-IWF will always set 'Application-Port-Identifier' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
},
"mandatePriority": {
"description": "This indicates whether to enforce SCS/AS provided priority or not. When set to false, then SCS/AS provided priority (if available) will be enforced. When set to true, MTC-IWF will always set the 'Priority-Indication' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"defaultApplicationPort": 1000,
"defaultPriority": "NonPriority",
"maxValidityPeriod": 3600,
"name": "DevTrig1",
"mandateApplicationPort": false,
"mandatePriority": false
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/devicetriggeringconfigurationsets/{name}
Updates the configuration of the specified Device Triggering. If the provided Device Triggering data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/devicetriggeringconfigurationset/devicetriggeringconfigurationset.json",
"properties": {
"defaultApplicationPort": {
"description": "When mandateApplicationPort is set to true, value of this parameter will be used (if not provided by T8) to set 'Application-Port-Identifier' AVP in SIR and DTR.",
"maximum": 65535,
"minimum": 0,
"default": 1000,
"type": "integer"
},
"defaultPriority": {
"description": "When mandatePriority is set to true, value of this parameter will be used (if not provided by T8) to populate 'Priority-Indication' AVP in SIR and DTR.",
"enum": [
"NonPriority",
"Priority"
],
"default": "NonPriority",
"type": "string"
},
"maxValidityPeriod": {
"description": "Maximum allowed validity period in seconds. The value -1 indicates no check of validity period will be performed by SCEF/MTC-IWF.",
"maximum": 86400,
"minimum": -1,
"default": 3600,
"type": "integer"
},
"name": {
"description": "The name of the Device Triggering configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"mandateApplicationPort": {
"description": "This indicates whether to enforce SCS/AS provided application port or not. When set to false, then SCS/AS provided application port (if available) will be enforced. When set to true, MTC-IWF will always set 'Application-Port-Identifier' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
},
"mandatePriority": {
"description": "This indicates whether to enforce SCS/AS provided priority or not. When set to false, then SCS/AS provided priority (if available) will be enforced. When set to true, MTC-IWF will always set the 'Priority-Indication' AVP in SIR and DTR.",
"default": false,
"type": "boolean"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"defaultApplicationPort": 1000,
"defaultPriority": "NonPriority",
"maxValidityPeriod": 3600,
"name": "DevTrig1",
"mandateApplicationPort": false,
"mandatePriority": false
}
delete /scef/devicetriggeringconfigurationsets/{name}
Deletes the specified Device Triggering from the SOAM configuration. An attempt to delete a Device Triggering which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Monitoring Event Configuration
A monitoring event configuration entry consists of a name and configuration-specific data.
All configuration of the monitoring event is done at the SOAM.
/scef/monitoringeventconfigurationsets
get /scef/monitoringeventconfigurationsets
Returns all monitoring event configurations that meet the criteria specified in the GET request. By default, all monitoring events configured at the SOAM are returned. If paging parameters are supplied, only those monitoring event configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/monitoringeventconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringeventconfigurationset/monitoringeventconfigurationset.json",
"properties": {
"downlinkPackets": {
"description": "Maximum value of 'suggestedNumberOfDlPackets' parameter provided by SCS/AS.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"enforceReportingInterval": {
"description": "This specifies whether reporting interval is mandatory in CIR or not. When set to false, reporting interval is optional for location reporting. When set to true, reporting interval will be a mandatory field in CIR for location reporting.",
"default": false,
"type": "boolean"
},
"groupedMonitoringEnabled": {
"description": "This specifies grouped monitoring is enabled or not. When set to false, SCS/AS can request single UE monitoring only. When set to true, SCEF will allow external grouped monitoring.",
"default": false,
"type": "boolean"
},
"locationAccuracy": {
"description": "Default accuracy for location reporting.",
"enum": [
"CgiEcgi",
"eNB",
"LaTaRa",
"PLMN"
],
"default": "eNB",
"type": "string"
},
"maxMonitoringDuration": {
"description": "Maximum allowed monitoring duration in seconds.",
"maximum": 864000,
"minimum": 1,
"default": 3600,
"type": "integer"
},
"maxResponseTime": {
"description": "Maximum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxTauRauTimerValue": {
"description": "Maximum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxUePerReport": {
"description": "Maximum number of UE(s) data to be included in a single HTTP monitoring event notification.",
"maximum": 100,
"minimum": 1,
"default": 50,
"type": "integer"
},
"minReportingInterval": {
"description": "Minimum value of 'minimumReportInterval' parameter in seconds provided by SCS/AS.",
"maximum": 86400,
"minimum": 1,
"default": 120,
"type": "integer"
},
"minResponseTime": {
"description": "Minimum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"minTauRauTimerValue": {
"description": "Minimum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"monitoringType": {
"description": "Supported monitoring types in configuration set.",
"items": {
"enum": [
"LossOfConnectivity",
"UEReachability",
"LocationReporting",
"ChangeOfImsiImeiAssociation",
"RoamingStatus",
"CommunicationFailure",
"AvailabilityAfterDdnFailure",
"NumberOfUEsInAnArea"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"name": {
"description": "The name of the Monitoring Event configuration set.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"numberOfReports": {
"description": "Maximum number of reports that will be generated for each user at a time.",
"maximum": 5000,
"minimum": 1,
"default": 1,
"type": "integer"
}
},
"required": [
"monitoringType",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"monitoringType": [
"UEReachability",
"LocationReporting"
],
"name": "MONEVENT1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/monitoringeventconfigurationsets
Adds a new monitoring event to the SCEF configuration. The monitoring event configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringeventconfigurationset/monitoringeventconfigurationset.json",
"properties": {
"downlinkPackets": {
"description": "Maximum value of 'suggestedNumberOfDlPackets' parameter provided by SCS/AS.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"enforceReportingInterval": {
"description": "This specifies whether reporting interval is mandatory in CIR or not. When set to false, reporting interval is optional for location reporting. When set to true, reporting interval will be a mandatory field in CIR for location reporting.",
"default": false,
"type": "boolean"
},
"groupedMonitoringEnabled": {
"description": "This specifies grouped monitoring is enabled or not. When set to false, SCS/AS can request single UE monitoring only. When set to true, SCEF will allow external grouped monitoring.",
"default": false,
"type": "boolean"
},
"locationAccuracy": {
"description": "Default accuracy for location reporting.",
"enum": [
"CgiEcgi",
"eNB",
"LaTaRa",
"PLMN"
],
"default": "eNB",
"type": "string"
},
"maxMonitoringDuration": {
"description": "Maximum allowed monitoring duration in seconds.",
"maximum": 864000,
"minimum": 1,
"default": 3600,
"type": "integer"
},
"maxResponseTime": {
"description": "Maximum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxTauRauTimerValue": {
"description": "Maximum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxUePerReport": {
"description": "Maximum number of UE(s) data to be included in a single HTTP monitoring event notification.",
"maximum": 100,
"minimum": 1,
"default": 50,
"type": "integer"
},
"minReportingInterval": {
"description": "Minimum value of 'minimumReportInterval' parameter in seconds provided by SCS/AS.",
"maximum": 86400,
"minimum": 1,
"default": 120,
"type": "integer"
},
"minResponseTime": {
"description": "Minimum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"minTauRauTimerValue": {
"description": "Minimum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"monitoringType": {
"description": "Supported monitoring types in configuration set.",
"items": {
"enum": [
"LossOfConnectivity",
"UEReachability",
"LocationReporting",
"ChangeOfImsiImeiAssociation",
"RoamingStatus",
"CommunicationFailure",
"AvailabilityAfterDdnFailure",
"NumberOfUEsInAnArea"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"name": {
"description": "The name of the Monitoring Event configuration set.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"numberOfReports": {
"description": "Maximum number of reports that will be generated for each user at a time.",
"maximum": 5000,
"minimum": 1,
"default": 1,
"type": "integer"
}
},
"required": [
"monitoringType",
"name"
],
"type": "object"
}
Example
{
"monitoringType": [
"UEReachability",
"LocationReporting"
],
"name": "MONEVENT1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/monitoringeventconfigurationsets/{name}
get /scef/monitoringeventconfigurationsets/{name}
Returns the configuration details for the specified monitoring event. If the monitoring event does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/monitoringeventconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringeventconfigurationset/monitoringeventconfigurationset.json",
"properties": {
"downlinkPackets": {
"description": "Maximum value of 'suggestedNumberOfDlPackets' parameter provided by SCS/AS.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"enforceReportingInterval": {
"description": "This specifies whether reporting interval is mandatory in CIR or not. When set to false, reporting interval is optional for location reporting. When set to true, reporting interval will be a mandatory field in CIR for location reporting.",
"default": false,
"type": "boolean"
},
"groupedMonitoringEnabled": {
"description": "This specifies grouped monitoring is enabled or not. When set to false, SCS/AS can request single UE monitoring only. When set to true, SCEF will allow external grouped monitoring.",
"default": false,
"type": "boolean"
},
"locationAccuracy": {
"description": "Default accuracy for location reporting.",
"enum": [
"CgiEcgi",
"eNB",
"LaTaRa",
"PLMN"
],
"default": "eNB",
"type": "string"
},
"maxMonitoringDuration": {
"description": "Maximum allowed monitoring duration in seconds.",
"maximum": 864000,
"minimum": 1,
"default": 3600,
"type": "integer"
},
"maxResponseTime": {
"description": "Maximum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxTauRauTimerValue": {
"description": "Maximum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxUePerReport": {
"description": "Maximum number of UE(s) data to be included in a single HTTP monitoring event notification.",
"maximum": 100,
"minimum": 1,
"default": 50,
"type": "integer"
},
"minReportingInterval": {
"description": "Minimum value of 'minimumReportInterval' parameter in seconds provided by SCS/AS.",
"maximum": 86400,
"minimum": 1,
"default": 120,
"type": "integer"
},
"minResponseTime": {
"description": "Minimum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"minTauRauTimerValue": {
"description": "Minimum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"monitoringType": {
"description": "Supported monitoring types in configuration set.",
"items": {
"enum": [
"LossOfConnectivity",
"UEReachability",
"LocationReporting",
"ChangeOfImsiImeiAssociation",
"RoamingStatus",
"CommunicationFailure",
"AvailabilityAfterDdnFailure",
"NumberOfUEsInAnArea"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"name": {
"description": "The name of the Monitoring Event configuration set.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"numberOfReports": {
"description": "Maximum number of reports that will be generated for each user at a time.",
"maximum": 5000,
"minimum": 1,
"default": 1,
"type": "integer"
}
},
"required": [
"monitoringType",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"monitoringType": [
"UEReachability",
"LocationReporting"
],
"name": "MONEVENT1"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/monitoringeventconfigurationsets/{name}
Updates the configuration of the specified monitoring event. If the provided monitoring event data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringeventconfigurationset/monitoringeventconfigurationset.json",
"properties": {
"downlinkPackets": {
"description": "Maximum value of 'suggestedNumberOfDlPackets' parameter provided by SCS/AS.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"enforceReportingInterval": {
"description": "This specifies whether reporting interval is mandatory in CIR or not. When set to false, reporting interval is optional for location reporting. When set to true, reporting interval will be a mandatory field in CIR for location reporting.",
"default": false,
"type": "boolean"
},
"groupedMonitoringEnabled": {
"description": "This specifies grouped monitoring is enabled or not. When set to false, SCS/AS can request single UE monitoring only. When set to true, SCEF will allow external grouped monitoring.",
"default": false,
"type": "boolean"
},
"locationAccuracy": {
"description": "Default accuracy for location reporting.",
"enum": [
"CgiEcgi",
"eNB",
"LaTaRa",
"PLMN"
],
"default": "eNB",
"type": "string"
},
"maxMonitoringDuration": {
"description": "Maximum allowed monitoring duration in seconds.",
"maximum": 864000,
"minimum": 1,
"default": 3600,
"type": "integer"
},
"maxResponseTime": {
"description": "Maximum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxTauRauTimerValue": {
"description": "Maximum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maxUePerReport": {
"description": "Maximum number of UE(s) data to be included in a single HTTP monitoring event notification.",
"maximum": 100,
"minimum": 1,
"default": 50,
"type": "integer"
},
"minReportingInterval": {
"description": "Minimum value of 'minimumReportInterval' parameter in seconds provided by SCS/AS.",
"maximum": 86400,
"minimum": 1,
"default": 120,
"type": "integer"
},
"minResponseTime": {
"description": "Minimum value of 'maximumResponseTime' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"minTauRauTimerValue": {
"description": "Minimum value of 'maximumDetectionTime' or 'maximumLatency' parameter in seconds provided by SCS/AS.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"monitoringType": {
"description": "Supported monitoring types in configuration set.",
"items": {
"enum": [
"LossOfConnectivity",
"UEReachability",
"LocationReporting",
"ChangeOfImsiImeiAssociation",
"RoamingStatus",
"CommunicationFailure",
"AvailabilityAfterDdnFailure",
"NumberOfUEsInAnArea"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"name": {
"description": "The name of the Monitoring Event configuration set.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"numberOfReports": {
"description": "Maximum number of reports that will be generated for each user at a time.",
"maximum": 5000,
"minimum": 1,
"default": 1,
"type": "integer"
}
},
"required": [
"monitoringType",
"name"
],
"type": "object"
}
Example
{
"monitoringType": [
"UEReachability",
"LocationReporting"
],
"name": "MONEVENT1"
}
delete /scef/monitoringeventconfigurationsets/{name}
Deletes the specified monitoring event from the SOAM configuration. An attempt to delete a monitoring event which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: NIDD Configuration
A Non-IP Data Delivery configuration entry consists of a name and configuration-specific data.
All configuration of the NIDD is done at the SOAM.
/scef/niddconfigurationsets
get /scef/niddconfigurationsets
Returns all NIDD configurations that meet the criteria specified in the GET request. By default, all NIDDs configured at the SOAM are returned. If paging parameters are supplied, only those NIDD configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/niddconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/niddconfigurationset/niddconfigurationset.json",
"properties": {
"dataDuration": {
"description": "Default SCS NIDD data duration in seconds. The value 0 indicates that buffering of data messages is not supported.",
"maximum": 2678400,
"minimum": 0,
"default": 0,
"type": "integer"
},
"maxAuthDuration": {
"description": "Max SCS NIDD authentication duration in seconds.",
"maximum": 1000000000,
"minimum": 60,
"default": 31536000,
"type": "integer"
},
"maxOnholdDataMsg": {
"description": "Max number of on-hold messages.",
"maximum": 5,
"minimum": 1,
"default": 1,
"type": "integer"
},
"minRetransmissionTime": {
"description": "MT retransmission buffer time in seconds before expiry.",
"maximum": 10,
"minimum": 0,
"default": 5,
"type": "integer"
},
"name": {
"description": "The name of the NIDD configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"pdnEstablishmentOption": {
"description": "PDN Establishment Option.",
"enum": [
"WAIT_FOR_UE",
"INDICATE_ERROR"
],
"default": "INDICATE_ERROR",
"type": "string"
},
"pdnEstablishmentOptionEnabled": {
"description": "This specifies PDN Establishment Option is enabled or not. When set to false, PDN Establishment Option is not supported. When set to true, PDN Establishment Option is supported.",
"default": false,
"type": "boolean"
},
"priority": {
"description": "Diameter Routing Message Priority value used while sending TDR message to MME/SGSN when SCS/AS does not include priority.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"dataDuration": 20,
"maxAuthDuration": 86400,
"maxOnholdDataMsg": 1,
"minRetransmissionTime": 6,
"name": "NIDDCFG1",
"pdnEstablishmentOption": "INDICATE_ERROR",
"pdnEstablishmentOptionEnabled": false,
"priority": 0
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/niddconfigurationsets
Adds a new NIDD to the SCEF configuration. The NIDD configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/niddconfigurationset/niddconfigurationset.json",
"properties": {
"dataDuration": {
"description": "Default SCS NIDD data duration in seconds. The value 0 indicates that buffering of data messages is not supported.",
"maximum": 2678400,
"minimum": 0,
"default": 0,
"type": "integer"
},
"maxAuthDuration": {
"description": "Max SCS NIDD authentication duration in seconds.",
"maximum": 1000000000,
"minimum": 60,
"default": 31536000,
"type": "integer"
},
"maxOnholdDataMsg": {
"description": "Max number of on-hold messages.",
"maximum": 5,
"minimum": 1,
"default": 1,
"type": "integer"
},
"minRetransmissionTime": {
"description": "MT retransmission buffer time in seconds before expiry.",
"maximum": 10,
"minimum": 0,
"default": 5,
"type": "integer"
},
"name": {
"description": "The name of the NIDD configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"pdnEstablishmentOption": {
"description": "PDN Establishment Option.",
"enum": [
"WAIT_FOR_UE",
"INDICATE_ERROR"
],
"default": "INDICATE_ERROR",
"type": "string"
},
"pdnEstablishmentOptionEnabled": {
"description": "This specifies PDN Establishment Option is enabled or not. When set to false, PDN Establishment Option is not supported. When set to true, PDN Establishment Option is supported.",
"default": false,
"type": "boolean"
},
"priority": {
"description": "Diameter Routing Message Priority value used while sending TDR message to MME/SGSN when SCS/AS does not include priority.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"dataDuration": 20,
"maxAuthDuration": 86400,
"maxOnholdDataMsg": 1,
"minRetransmissionTime": 6,
"name": "NIDDCFG1",
"pdnEstablishmentOption": "INDICATE_ERROR",
"pdnEstablishmentOptionEnabled": false,
"priority": 0
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/niddconfigurationsets/{name}
get /scef/niddconfigurationsets/{name}
Returns the configuration details for the specified NIDD. If the NIDD does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/niddconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/niddconfigurationset/niddconfigurationset.json",
"properties": {
"dataDuration": {
"description": "Default SCS NIDD data duration in seconds. The value 0 indicates that buffering of data messages is not supported.",
"maximum": 2678400,
"minimum": 0,
"default": 0,
"type": "integer"
},
"maxAuthDuration": {
"description": "Max SCS NIDD authentication duration in seconds.",
"maximum": 1000000000,
"minimum": 60,
"default": 31536000,
"type": "integer"
},
"maxOnholdDataMsg": {
"description": "Max number of on-hold messages.",
"maximum": 5,
"minimum": 1,
"default": 1,
"type": "integer"
},
"minRetransmissionTime": {
"description": "MT retransmission buffer time in seconds before expiry.",
"maximum": 10,
"minimum": 0,
"default": 5,
"type": "integer"
},
"name": {
"description": "The name of the NIDD configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"pdnEstablishmentOption": {
"description": "PDN Establishment Option.",
"enum": [
"WAIT_FOR_UE",
"INDICATE_ERROR"
],
"default": "INDICATE_ERROR",
"type": "string"
},
"pdnEstablishmentOptionEnabled": {
"description": "This specifies PDN Establishment Option is enabled or not. When set to false, PDN Establishment Option is not supported. When set to true, PDN Establishment Option is supported.",
"default": false,
"type": "boolean"
},
"priority": {
"description": "Diameter Routing Message Priority value used while sending TDR message to MME/SGSN when SCS/AS does not include priority.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"dataDuration": 20,
"maxAuthDuration": 86400,
"maxOnholdDataMsg": 1,
"minRetransmissionTime": 6,
"name": "NIDDCFG1",
"pdnEstablishmentOption": "INDICATE_ERROR",
"pdnEstablishmentOptionEnabled": false,
"priority": 0
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/niddconfigurationsets/{name}
Updates the configuration of the specified NIDD. If the provided NIDD data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/niddconfigurationset/niddconfigurationset.json",
"properties": {
"dataDuration": {
"description": "Default SCS NIDD data duration in seconds. The value 0 indicates that buffering of data messages is not supported.",
"maximum": 2678400,
"minimum": 0,
"default": 0,
"type": "integer"
},
"maxAuthDuration": {
"description": "Max SCS NIDD authentication duration in seconds.",
"maximum": 1000000000,
"minimum": 60,
"default": 31536000,
"type": "integer"
},
"maxOnholdDataMsg": {
"description": "Max number of on-hold messages.",
"maximum": 5,
"minimum": 1,
"default": 1,
"type": "integer"
},
"minRetransmissionTime": {
"description": "MT retransmission buffer time in seconds before expiry.",
"maximum": 10,
"minimum": 0,
"default": 5,
"type": "integer"
},
"name": {
"description": "The name of the NIDD configuration set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"pdnEstablishmentOption": {
"description": "PDN Establishment Option.",
"enum": [
"WAIT_FOR_UE",
"INDICATE_ERROR"
],
"default": "INDICATE_ERROR",
"type": "string"
},
"pdnEstablishmentOptionEnabled": {
"description": "This specifies PDN Establishment Option is enabled or not. When set to false, PDN Establishment Option is not supported. When set to true, PDN Establishment Option is supported.",
"default": false,
"type": "boolean"
},
"priority": {
"description": "Diameter Routing Message Priority value used while sending TDR message to MME/SGSN when SCS/AS does not include priority.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"dataDuration": 20,
"maxAuthDuration": 86400,
"maxOnholdDataMsg": 1,
"minRetransmissionTime": 6,
"name": "NIDDCFG1",
"pdnEstablishmentOption": "INDICATE_ERROR",
"pdnEstablishmentOptionEnabled": false,
"priority": 0
}
delete /scef/niddconfigurationsets/{name}
Deletes the specified NIDD from the SOAM configuration. An attempt to delete a NIDD which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Options
The Service Capability Exposure Function (SCEF) Options are those configuration values that govern the overall SCEF functionality . There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new SCEF Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All SCEF Options configuration is done at the SOAM.
/scef/options
get /scef/options
Returns the set of current values for the SCEF Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/optionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/option/option.json",
"properties": {
"apiGwIpList": {
"description": "List of IP addresses of API Gateway servers. Each value provided must be a valid IPv4 address.",
"items": {
"type": "string"
},
"maxItems": 16,
"minItems": 1,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$",
"type": "array"
},
"art": {
"description": "The name of the Application Route Table (/diameter/applicationroutetables) to be used for routing application diameter request messages through RBAR/FABR.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"binaryEncoder": {
"description": "The binary-to-text encoding scheme to be used to communicate to SCS/AS over T8 interface.",
"enum": [
"ASCII",
"Base2",
"Base16",
"Base64"
],
"default": "Base64",
"type": "string"
},
"longestSubdomainMatchEnabled": {
"description": "This specifies longest suffix subdomain match is enabled or not. When set to false, ACL domain match will be performed on exact match basis . When set to true, domain match will be retried for all subdomains under UEs domain.",
"default": false,
"type": "boolean"
},
"priority": {
"description": "DRMP priority of NIR, ACR and CMR messages originated by SCEF.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
},
"prt": {
"description": "The name of the Peer Route Table (/diameter/peerroutetables) for routing application generated diameter request messages.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"retryDbUpdate": {
"description": "The maximum number of attempts for concurrent DB Updates.",
"maximum": 5,
"minimum": 0,
"default": 2,
"type": "integer"
},
"scefId": {
"description": "Diameter Identity for SCEF. This should be configured as one of the Local Node's FQDN (/diameter/localnodes).",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"scefWaitTime": {
"description": "This is the time in seconds SCEF waits for an answer from a MME/SGSN after forwarding a downlink data delivery request.",
"maximum": 180,
"minimum": 1,
"default": 1,
"type": "integer"
},
"servingPlmnRateControlEnabled": {
"description": "This specifies Serving PLMN Rate Control is enabled or not. When set to false, Serving PLMN Rate Control is not enabled. When set to true, Serving PLMN Rate Control is enabled.",
"default": false,
"type": "boolean"
},
"supportedFeatureListId": {
"description": "List of features supported by SCEF.",
"maximum": 4294967295,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"apiGwIpList": [
"020.20.20.2",
"20.20.20.4"
],
"priority": 3,
"art": "ART1",
"prt": "PRT1",
"retryDbUpdate": 2,
"scefId": "oracle.com",
"scefWaitTime": 1200,
"servingPlmnRateControlEnabled": true,
"supportedFeatureListId": 0
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /scef/options
Update the SCEF Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/option/option.json",
"properties": {
"apiGwIpList": {
"description": "List of IP addresses of API Gateway servers. Each value provided must be a valid IPv4 address.",
"items": {
"type": "string"
},
"maxItems": 16,
"minItems": 1,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$",
"type": "array"
},
"art": {
"description": "The name of the Application Route Table (/diameter/applicationroutetables) to be used for routing application diameter request messages through RBAR/FABR.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"binaryEncoder": {
"description": "The binary-to-text encoding scheme to be used to communicate to SCS/AS over T8 interface.",
"enum": [
"ASCII",
"Base2",
"Base16",
"Base64"
],
"default": "Base64",
"type": "string"
},
"longestSubdomainMatchEnabled": {
"description": "This specifies longest suffix subdomain match is enabled or not. When set to false, ACL domain match will be performed on exact match basis . When set to true, domain match will be retried for all subdomains under UEs domain.",
"default": false,
"type": "boolean"
},
"priority": {
"description": "DRMP priority of NIR, ACR and CMR messages originated by SCEF.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
},
"prt": {
"description": "The name of the Peer Route Table (/diameter/peerroutetables) for routing application generated diameter request messages.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"retryDbUpdate": {
"description": "The maximum number of attempts for concurrent DB Updates.",
"maximum": 5,
"minimum": 0,
"default": 2,
"type": "integer"
},
"scefId": {
"description": "Diameter Identity for SCEF. This should be configured as one of the Local Node's FQDN (/diameter/localnodes).",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"scefWaitTime": {
"description": "This is the time in seconds SCEF waits for an answer from a MME/SGSN after forwarding a downlink data delivery request.",
"maximum": 180,
"minimum": 1,
"default": 1,
"type": "integer"
},
"servingPlmnRateControlEnabled": {
"description": "This specifies Serving PLMN Rate Control is enabled or not. When set to false, Serving PLMN Rate Control is not enabled. When set to true, Serving PLMN Rate Control is enabled.",
"default": false,
"type": "boolean"
},
"supportedFeatureListId": {
"description": "List of features supported by SCEF.",
"maximum": 4294967295,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": [],
"type": "object"
}
Example
{
"apiGwIpList": [
"020.20.20.2",
"20.20.20.4"
],
"priority": 3,
"art": "ART1",
"prt": "PRT1",
"retryDbUpdate": 2,
"scefId": "oracle.com",
"scefWaitTime": 1200,
"servingPlmnRateControlEnabled": true,
"supportedFeatureListId": 0
}
Scef: SCS Application Server
An SCS/AS configuration entry consists of a scsAsId and configuration-specific data.
All configuration of the SCS/AS is done at the SOAM.
/scef/scsapplicationservers
get /scef/scsapplicationservers
Returns all SCS/AS configurations that meet the criteria specified in the GET request. By default, all SCS/AS configured at the SOAM are returned. If paging parameters are supplied, only those SCS/AS configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/scsapplicationserverCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/scsapplicationserver/scsapplicationserver.json",
"properties": {
"aclName": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"apnCfgSetName": {
"description": "APN configuration set name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"callbackUrl": {
"description": "This callback URL will be used for sending MO data to SCS/AS.",
"maxLength": 300,
"type": "string"
},
"deviceTriggeringCfgSetName": {
"description": "Device Triggering configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"interimInterval": {
"description": "Time interval in seconds for sending interim Accounting Charging Request messages.",
"maximum": 3600,
"minimum": 10,
"default": 600,
"type": "integer"
},
"isEcrAllowed": {
"description": "This indicates whether Enhanced Coverage Restriction (ECR) is allowed or not. When set to false, ECR is not allowed. When set to true, ECR is allowed.",
"default": false,
"type": "boolean"
},
"monitoringEventCfgSetName": {
"description": "Monitoring Event configuration set name.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"niddCfgSetName": {
"description": "NIDD configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsId": {
"description": "The SCS/AS identifier.",
"maxLength": 46,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsIsdn": {
"description": "ISDN number of the SCS/AS in international ISDN number format.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"smsScFqdn": {
"description": "This is to be used when routing message to SMS-SC. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"smsScRealm": {
"description": "This is to be used when routing message to SMS-SC. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"callbackUrl",
"scsAsId"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"apnCfgSetName": "apn1.test.com",
"callbackUrl": "https://test.xyz.com",
"interimInterval": 600,
"niddCfgSetName": "NIDDCFG1",
"scsAsId": "SCSAS1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/scsapplicationservers
Adds a new SCS/AS. The SCS/AS configuration name(scsAsId) must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/scsapplicationserver/scsapplicationserver.json",
"properties": {
"aclName": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"apnCfgSetName": {
"description": "APN configuration set name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"callbackUrl": {
"description": "This callback URL will be used for sending MO data to SCS/AS.",
"maxLength": 300,
"type": "string"
},
"deviceTriggeringCfgSetName": {
"description": "Device Triggering configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"interimInterval": {
"description": "Time interval in seconds for sending interim Accounting Charging Request messages.",
"maximum": 3600,
"minimum": 10,
"default": 600,
"type": "integer"
},
"isEcrAllowed": {
"description": "This indicates whether Enhanced Coverage Restriction (ECR) is allowed or not. When set to false, ECR is not allowed. When set to true, ECR is allowed.",
"default": false,
"type": "boolean"
},
"monitoringEventCfgSetName": {
"description": "Monitoring Event configuration set name.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"niddCfgSetName": {
"description": "NIDD configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsId": {
"description": "The SCS/AS identifier.",
"maxLength": 46,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsIsdn": {
"description": "ISDN number of the SCS/AS in international ISDN number format.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"smsScFqdn": {
"description": "This is to be used when routing message to SMS-SC. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"smsScRealm": {
"description": "This is to be used when routing message to SMS-SC. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"callbackUrl",
"scsAsId"
],
"type": "object"
}
Example
{
"apnCfgSetName": "apn1.test.com",
"callbackUrl": "https://test.xyz.com",
"interimInterval": 600,
"niddCfgSetName": "NIDDCFG1",
"scsAsId": "SCSAS1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/scsapplicationservers/{name}
get /scef/scsapplicationservers/{name}
Returns the configuration details for the specified SCS/AS. If the SCS/AS does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/scsapplicationserverItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/scsapplicationserver/scsapplicationserver.json",
"properties": {
"aclName": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"apnCfgSetName": {
"description": "APN configuration set name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"callbackUrl": {
"description": "This callback URL will be used for sending MO data to SCS/AS.",
"maxLength": 300,
"type": "string"
},
"deviceTriggeringCfgSetName": {
"description": "Device Triggering configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"interimInterval": {
"description": "Time interval in seconds for sending interim Accounting Charging Request messages.",
"maximum": 3600,
"minimum": 10,
"default": 600,
"type": "integer"
},
"isEcrAllowed": {
"description": "This indicates whether Enhanced Coverage Restriction (ECR) is allowed or not. When set to false, ECR is not allowed. When set to true, ECR is allowed.",
"default": false,
"type": "boolean"
},
"monitoringEventCfgSetName": {
"description": "Monitoring Event configuration set name.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"niddCfgSetName": {
"description": "NIDD configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsId": {
"description": "The SCS/AS identifier.",
"maxLength": 46,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsIsdn": {
"description": "ISDN number of the SCS/AS in international ISDN number format.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"smsScFqdn": {
"description": "This is to be used when routing message to SMS-SC. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"smsScRealm": {
"description": "This is to be used when routing message to SMS-SC. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"callbackUrl",
"scsAsId"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"apnCfgSetName": "apn1.test.com",
"callbackUrl": "https://test.xyz.com",
"interimInterval": 600,
"niddCfgSetName": "NIDDCFG1",
"scsAsId": "SCSAS1"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/scsapplicationservers/{name}
Updates the configuration of the specified SCS/AS. If the provided SCS/AS data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/scsapplicationserver/scsapplicationserver.json",
"properties": {
"aclName": {
"description": "The name of the Access Control List.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"apnCfgSetName": {
"description": "APN configuration set name.",
"maxLength": 102,
"pattern": "^[A-Za-z0-9_]+([.-]?[A-Za-z0-9_]+)*$",
"type": "string"
},
"callbackUrl": {
"description": "This callback URL will be used for sending MO data to SCS/AS.",
"maxLength": 300,
"type": "string"
},
"deviceTriggeringCfgSetName": {
"description": "Device Triggering configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"interimInterval": {
"description": "Time interval in seconds for sending interim Accounting Charging Request messages.",
"maximum": 3600,
"minimum": 10,
"default": 600,
"type": "integer"
},
"isEcrAllowed": {
"description": "This indicates whether Enhanced Coverage Restriction (ECR) is allowed or not. When set to false, ECR is not allowed. When set to true, ECR is allowed.",
"default": false,
"type": "boolean"
},
"monitoringEventCfgSetName": {
"description": "Monitoring Event configuration set name.",
"maxLength": 128,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"niddCfgSetName": {
"description": "NIDD configuration set name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsId": {
"description": "The SCS/AS identifier.",
"maxLength": 46,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type": "string"
},
"scsAsIsdn": {
"description": "ISDN number of the SCS/AS in international ISDN number format.",
"maxLength": 15,
"minLength": 8,
"pattern": "^([0-9]){8,15}$",
"type": "string"
},
"smsScFqdn": {
"description": "This is to be used when routing message to SMS-SC. FQDN is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
},
"smsScRealm": {
"description": "This is to be used when routing message to SMS-SC. Realm is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a Realm must be at most 255 characters long. At least Realm or Fully Qualified Domain Name is required to configure a Destination.",
"maxLength": 255,
"pattern": "^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type": "string"
}
},
"required": [
"callbackUrl",
"scsAsId"
],
"type": "object"
}
Example
{
"apnCfgSetName": "apn1.test.com",
"callbackUrl": "https://test.xyz.com",
"interimInterval": 600,
"niddCfgSetName": "NIDDCFG1",
"scsAsId": "SCSAS1"
}
delete /scef/scsapplicationservers/{name}
Deletes the specified SCS/AS from the SOAM configuration. An attempt to delete an SCS/AS which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Monitoring Location Area
The Monitoring Location Area configuration entry consists of a LocationAreaId and its configuration-specific data.
All configuration of the Monitoring Location Area is done at the SOAM.
/scef/monitoringlocationareas
get /scef/monitoringlocationareas
Returns all Monitoring Location Area Configurations that meet the criteria specified in the GET request. By default, all Monitoring Location Area configured at the SOAM are returned. If paging parameters are supplied, only those Monitoring Location Area configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/monitoringlocationareaCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringlocarea/monitoringlocarea.json",
"properties": {
"locationAreaCode":{
"description":"The LAC [Location Area Code] uniquely identifies a Location Area within a PLMN [Public Land Mobile network].LAC which is a fixed length code (of 2 octets).",
"maximum":65535,
"minimum":0,
"type":"integer"
},
"locationAreaType":{
"description":"Identifies the type of location area. It can be Routing area identity or Tracking area identity.",
"enum": [
"TRACKINGAREAID",
"ROUTINGAREAID"
],
"type": "string"
},
"mcc":{
"description":"The Mobile Country Code is always used with Mobile Network Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.The mobile country code consists of three decimal digits and the mobile network code consists of two or three decimal digits.The first digit of the mobile country code identifies the geographic region.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"mnc":{
"description":"The Mobile Network Code is always used with Mobile Country Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"poolName":{
"description":"Identifies the pool in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type":"string"
},
"routingAreaCodeStart":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"routingAreaCodeEnd":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeStart":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeEnd":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
}
},
"required": [
"locationAreaType",
"poolName",
"mcc",
"mnc"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"locationAreaCode" : 23455,
"poolName" : "pool100",
"locationAreaType" : "ROUTINGAREAID",
"mcc" : 123,
"mnc" : 125,
"routingAreaCodeStart" : 210,
"routingAreaCodeEnd" : 220
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /scef/monitoringlocationareas
Adds a new Monitoring Location Area to the SCEF configuration. The Monitoring Location Area configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringlocarea/monitoringlocarea.json",
"properties": {
"locationAreaCode":{
"description":"The LAC [Location Area Code] uniquely identifies a Location Area within a PLMN [Public Land Mobile network].LAC which is a fixed length code (of 2 octets).",
"maximum":65535,
"minimum":0,
"type":"integer"
},
"locationAreaType":{
"description":"Identifies the type of location area. It can be Routing area identity or Tracking area identity.",
"enum": [
"TRACKINGAREAID",
"ROUTINGAREAID"
],
"type": "string"
},
"mcc":{
"description":"The Mobile Country Code is always used with Mobile Network Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.The mobile country code consists of three decimal digits and the mobile network code consists of two or three decimal digits.The first digit of the mobile country code identifies the geographic region.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"mnc":{
"description":"The Mobile Network Code is always used with Mobile Country Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"poolName":{
"description":"Identifies the pool in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type":"string"
},
"routingAreaCodeStart":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"routingAreaCodeEnd":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeStart":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeEnd":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
}
},
"required": [
"locationAreaType",
"poolName",
"mcc",
"mnc"
],
"type": "object"
}
Example
{
"locationAreaCode" : 23455,
"poolName" : "pool100",
"locationAreaType" : "ROUTINGAREAID",
"mcc" : 123,
"mnc" : 125,
"routingAreaCodeStart" : 210,
"routingAreaCodeEnd" : 220
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/monitoringlocationareas/{name}
get /scef/monitoringlocationareas/{name}
Returns the configuration details for the specified Monitoring Location Area.If User wants details of record in TrackingAreaId Table entry then User has to provide locationAreaType as TRACKINGAREAID, PoolName, MCC, MNC, trackingAreaCode(TAC)Start and trackingAreaCode(TAC)End separated by a colon (:). The identifier for this operation will become TRACKINGAREAID:poolname:mcc:mnc:TACStart:TACEnd. If User wants details of record in RoutingAreaId Table entry then User has to provide locationAreaType as ROUTINGAREAID, poolName, MCC, MNC, locationAreaCode(LAC), routingAreaCode(RAC)Start and routingAreaCode(RAC)End separated by a colon (:). The identifier for this operation will become ROUTINGAREAID:poolname:mcc:mnc:LAC:RACStart:RACEnd. If the Monitoring Location Area does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/monitoringlocationareaItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringlocarea/monitoringlocarea.json",
"properties": {
"locationAreaCode":{
"description":"The LAC [Location Area Code] uniquely identifies a Location Area within a PLMN [Public Land Mobile network].LAC which is a fixed length code (of 2 octets).",
"maximum":65535,
"minimum":0,
"type":"integer"
},
"locationAreaType":{
"description":"Identifies the type of location area. It can be Routing area identity or Tracking area identity.",
"enum": [
"TRACKINGAREAID",
"ROUTINGAREAID"
],
"type": "string"
},
"mcc":{
"description":"The Mobile Country Code is always used with Mobile Network Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.The mobile country code consists of three decimal digits and the mobile network code consists of two or three decimal digits.The first digit of the mobile country code identifies the geographic region.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"mnc":{
"description":"The Mobile Network Code is always used with Mobile Country Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"poolName":{
"description":"Identifies the pool in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type":"string"
},
"routingAreaCodeStart":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"routingAreaCodeEnd":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeStart":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeEnd":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
}
},
"required": [
"locationAreaType",
"poolName",
"mcc",
"mnc"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"locationAreaCode" : 23455,
"poolName" : "pool100",
"locationAreaType" : "ROUTINGAREAID",
"mcc" : 123,
"mnc" : 125,
"routingAreaCodeStart" : 210,
"routingAreaCodeEnd" : 220
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /scef/monitoringlocationareas/{name}
Updates the configuration of the specified Monitoring Location Area with the new Pool name provided. If the provided Monitoring Location Area data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringlocarea/monitoringlocarea.json",
"properties": {
"locationAreaCode":{
"description":"The LAC [Location Area Code] uniquely identifies a Location Area within a PLMN [Public Land Mobile network].LAC which is a fixed length code (of 2 octets).",
"maximum":65535,
"minimum":0,
"type":"integer"
},
"locationAreaType":{
"description":"Identifies the type of location area. It can be Routing area identity or Tracking area identity.",
"enum": [
"TRACKINGAREAID",
"ROUTINGAREAID"
],
"type": "string"
},
"mcc":{
"description":"The Mobile Country Code is always used with Mobile Network Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.The mobile country code consists of three decimal digits and the mobile network code consists of two or three decimal digits.The first digit of the mobile country code identifies the geographic region.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"mnc":{
"description":"The Mobile Network Code is always used with Mobile Country Code and also called as MCC/MNC Tuple. The codes are basically used to identify the mobile network operator.",
"maximum":999,
"minimum":0,
"type":"integer"
},
"poolName":{
"description":"Identifies the pool in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type":"string"
},
"routingAreaCodeStart":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"routingAreaCodeEnd":{
"description":"The Routing Area Code is a fixed length of 1 octet and identifies a routing area within a location area. The RAC is part of the RAI (Routing Area Identity).",
"maximum":255,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeStart":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
},
"trackingAreaCodeEnd":{
"description":"The Tracking Area Code is the unique code that each operator assigns to each of their Tracking areas. The TAC is part of the TAI (Tracking Area Identity).The Tracking Area Code (TAC) is a fixed length code (of 2 octets) identifying a Tracking Area within a PLMN.",
"maximum":4294967295,
"minimum":0,
"type":"integer"
}
},
"required": [
"locationAreaType",
"poolName",
"mcc",
"mnc"
],
"type": "object"
}
Example
{
"locationAreaCode" : 23455,
"poolName" : "pool100",
"locationAreaType" : "ROUTINGAREAID",
"mcc" : 123,
"mnc" : 125,
"routingAreaCodeStart" : 210,
"routingAreaCodeEnd" : 220
}
delete /scef/monitoringlocationareas/{name}
Deletes the specified Monitoring Location Area from the SOAM configuration.If User wants to the delete TrackingAreaId Table entry then User has to provide locationAreaType as TRACKINGAREAID, PoolName, MCC, MNC, trackingAreaCode(TAC)Start and trackingAreaCode(TAC)End separated by a colon (:) to delete entry. The identifier for delete operation would become TRACKINGAREAID:poolname:mcc:mnc:TACStart:TACEnd. If User wants to the delete RoutingAreaId Table entry then User has to provide locationAreaType as ROUTINGAREAID, PoolName, MCC, MNC, locationAreaCode(LAC), routingAreaCode(RAC)Start and routingAreaCode(RAC)End separated by a colon (:) to delete entry. The identifier for delete operation would become ROUTINGAREAID:poolname:mcc:mnc:LAC:RACStart:RACEnd. An attempt to delete a Monitoring Location Area which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Scef: Monitoring Area Pool
The Monitoring Area Pool configuration entry consists of a Pool name and its configuration-specific data.
All configuration of the Monitoring Area Pool is done at the SOAM.
/scef/monitoringareapools
get /scef/monitoringareapools
Returns all Monitoring Area Pool Configurations that meet the criteria specified in the GET request. By default, all Monitoring Area Pool configured at the SOAM are returned. If paging parameters are supplied, only those Monitoring Area Pool configurations meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/collections/monitoringareapoolCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringareapool/monitoringareapool.json",
"properties": {
"poolName":{
"description":"Identifies the pool in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type":"string"
},
"locationAreaFqdn":{
"description":"Fqdn of the MME or Sgsn Server.It is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength":255,
"pattern":"^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
},
"locationAreaRealm":{
"description":"Identifies the realm in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern":"^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
}
},
"required": [
"poolName",
"locationAreaFqdn",
"locationAreaRealm"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"poolName" : "pool1",
"locationAreaFqdn" : "fqdn.domain.com",
"locationAreaRealm" : "realm.domain.com"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
post /scef/monitoringareapools
Adds a new Monitoring Area Pool to the SCEF configuration. The Monitoring Area Pool configuration name must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringareapool/monitoringareapool.json",
"properties": {
"poolName":{
"description":"Identifies the pool in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type":"string"
},
"locationAreaFqdn":{
"description":"Fqdn of the MME or Sgsn Server.It is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength":255,
"pattern":"^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
},
"locationAreaRealm":{
"description":"Identifies the realm in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern":"^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
}
},
"required": [
"poolName",
"locationAreaFqdn",
"locationAreaRealm"
],
"type": "object"
}
Example
{
"poolName" : "pool1",
"locationAreaFqdn" : "fqdn.domain.com",
"locationAreaRealm" : "realm.domain.com"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/scef/monitoringareapools/{name}
get /scef/monitoringareapools/{name}
Returns the configuration details for the specified Monitoring Area Pool.If User wants details of record in Table entry then User has to provide poolName,MME/SGSN FQDN name and Realm name separated by a colon (:). The identifier for this operation will become POOLNAME:FQDN:REALM. If the Monitoring Area Pool does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/scef/items/monitoringareapoolItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/scef/monitoringareapool/monitoringareapool.json",
"properties": {
"poolName":{
"description":"Identifies the pool in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern": "^(([A-Za-z][A-Za-z0-9_\\-\\.]*)|(_[A-Za-z0-9_\\-\\.]*[A-Za-z][A-Za-z0-9_\\-\\.]*))$",
"type":"string"
},
"locationAreaFqdn":{
"description":"Fqdn of the MME or Sgsn Server.It is a case-insensitive string consisting of a list of labels separated by dots, where a label may contain letters, digits, dashes ('-') and underscore ('_'). A label must start with a letter, digit or underscore and must end with a letter or digit. Underscores may be used only as the first character. A label must be at most 63 characters long and a FQDN must be at most 255 characters long.",
"maxLength":255,
"pattern":"^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
},
"locationAreaRealm":{
"description":"Identifies the realm in which the serving MME or SGSN is located.",
"maxLength":255,
"pattern":"^(?!\\-)(?:[a-zA-Z0-9\\-\\_]{0,63}[a-zA-Z0-9]\\.){1,64}(?!0-9+)[a-zA-Z0-9]{1,64}$",
"type":"string"
}
},
"required": [
"poolName",
"locationAreaFqdn",
"locationAreaRealm"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"poolName" : "pool1",
"locationAreaFqdn" : "fqdn.domain.com",
"locationAreaRealm" : "realm.domain.com"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /scef/monitoringareapools/{name}
Deletes the specified Monitoring Area Pool from the SOAM configuration.If User wants to the delete Table entry then User has to provide poolName, MME/SGSN FQDN name, REALM name separated by a colon (:) to delete entry. The identifier for delete operation would become POOLNAME:FQDN:REALM. An attempt to delete a Monitoring Area Pool which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Topo: DSCP Interface Rules
Differentiated Service Code Points (DSCP) rules can be associated with either ports or interfaces and allow packets to be classified for quality of service purposes.
Items in the DSCP Interface Rule collection don't have a simple natural identifier. Each time a new Interface Rule is created, it is assigned an identifier which is available as the UUID field.
Configuration of DSCP Interface Rules is only available at the NOAM.
/topo/dscpinterfacerules
get /topo/dscpinterfacerules
Returns the details for all configured DSCP Interface Rules that meet the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/dscpinterfaceruleCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/dscpinterfacerule/dscpinterfacerule.json",
"type": "object",
"required": ["interface","dscp","protocol","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"UUID": {
"type": "string",
"description": "DSCP Rule Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"interface": {
"type": "string",
"example": "eth01",
"description": "Server Interface"
},
"dscp": {
"type": "integer",
"minimum": 0,
"maximum": 63,
"example": 42,
"description": "DSCP Value"
},
"protocol": {
"type": "string",
"example": "Tcp",
"enum": [
"Sctp",
"Tcp"
],
"description": "Protocol"
},
"scope": {
"type": "string",
"example": "NO_SG",
"description": "Scope"
},
"scopeType": {
"type": "string",
"example": "ServerGroup",
"enum": [
"Server",
"ServerGroup"
],
"description": "Scope Type"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"UUID": "3529ac5f-1b2d-4154-bbe6-df8fa20bd3f9",
"interface": "eth0.1234",
"dscp": 23,
"protocol": "Tcp",
"scope": "snowman-noa",
"scopeType": "Server"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/dscpinterfacerules
Adds a new DSCP Interface Rule, which allows the DSCP field to be specified for all traffic exiting a server or server group via a specific interface.
A uuid is returned and is used to identify the Rule instance.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/dscpinterfacerule/dscpinterfacerule.json",
"type": "object",
"required": ["interface","dscp","protocol","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"UUID": {
"type": "string",
"description": "DSCP Rule Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"interface": {
"type": "string",
"example": "eth01",
"description": "Server Interface"
},
"dscp": {
"type": "integer",
"minimum": 0,
"maximum": 63,
"example": 42,
"description": "DSCP Value"
},
"protocol": {
"type": "string",
"example": "Tcp",
"enum": [
"Sctp",
"Tcp"
],
"description": "Protocol"
},
"scope": {
"type": "string",
"example": "NO_SG",
"description": "Scope"
},
"scopeType": {
"type": "string",
"example": "ServerGroup",
"enum": [
"Server",
"ServerGroup"
],
"description": "Scope Type"
}
}
}
Example
{
"UUID": "3529ac5f-1b2d-4154-bbe6-df8fa20bd3f9",
"interface": "eth0.1234",
"dscp": 23,
"protocol": "Tcp",
"scope": "snowman-noa",
"scopeType": "Server"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/dscpinterfacerules/{uuid}
get /topo/dscpinterfacerules/{uuid}
Returns the configuration details and a set of links for the specified DSCP Interface Rule. The links can be used to perform delete or edit operations on the Rule.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/dscpinterfaceruleItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/dscpinterfacerule/dscpinterfacerule.json",
"type": "object",
"required": ["interface","dscp","protocol","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"UUID": {
"type": "string",
"description": "DSCP Rule Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"interface": {
"type": "string",
"example": "eth01",
"description": "Server Interface"
},
"dscp": {
"type": "integer",
"minimum": 0,
"maximum": 63,
"example": 42,
"description": "DSCP Value"
},
"protocol": {
"type": "string",
"example": "Tcp",
"enum": [
"Sctp",
"Tcp"
],
"description": "Protocol"
},
"scope": {
"type": "string",
"example": "NO_SG",
"description": "Scope"
},
"scopeType": {
"type": "string",
"example": "ServerGroup",
"enum": [
"Server",
"ServerGroup"
],
"description": "Scope Type"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"UUID": "3529ac5f-1b2d-4154-bbe6-df8fa20bd3f9",
"interface": "eth0.1234",
"dscp": 23,
"protocol": "Tcp",
"scope": "snowman-noa",
"scopeType": "Server"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /topo/dscpinterfacerules/{uuid}
Deletes a DSCP Interface Rule, using a link returned by a previous GET operation.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Topo: DSCP Port Rules
Differentiated Service Code Points (DSCP) rules can be associated with either ports or interfaces and allow packets to be classified for quality of service purposes.
Items in the DSCP Port Rule collection don't have a simple natural identifier. Each time a new Port Rule is created, it is assigned an identifier which is available as the UUID field.
Configuration of DSCP Port Rules is only available at the NOAM.
/topo/dscpportrules
get /topo/dscpportrules
Returns the details for all configured DSCP Port Rules that meet the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/dscpportruleCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/dscpportrule/dscpportrule.json",
"type": "object",
"required": ["port","dscp","protocol","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"UUID": {
"type": "string",
"description": "DSCP Rule Identifier (*generated*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535,
"example": 1556,
"description": "Port"
},
"dscp": {
"type": "integer",
"example": 63,
"minimum": 0,
"maximum": 63,
"description": "The DSCP Value"
},
"protocol": {
"type": "string",
"example": "Tcp",
"enum": [
"Sctp",
"Tcp"
],
"description": "Protocol"
},
"scope": {
"type": "string",
"example": "snowman-noa",
"description": "Scope"
},
"scopeType": {
"type": "string",
"example": "Server",
"enum": [
"Server",
"ServerGroup"
],
"description": "Scope Type"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"UUID": "4f88a7d5-0894-42a0-be90-86e9f5892414",
"port": 535,
"dscp": 15,
"protocol": "Sctp",
"scope": "snowman-noa",
"scopeType": "Server"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/dscpportrules
Adds a new DSCP Port Rule, which allows the DSCP field to be specified for all traffic exiting a server or server group via a specific port.
The uuid is returned and is used to identify the Port Rule instance.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/dscpportrule/dscpportrule.json",
"type": "object",
"required": ["port","dscp","protocol","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"UUID": {
"type": "string",
"description": "DSCP Rule Identifier (*generated*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535,
"example": 1556,
"description": "Port"
},
"dscp": {
"type": "integer",
"example": 63,
"minimum": 0,
"maximum": 63,
"description": "The DSCP Value"
},
"protocol": {
"type": "string",
"example": "Tcp",
"enum": [
"Sctp",
"Tcp"
],
"description": "Protocol"
},
"scope": {
"type": "string",
"example": "snowman-noa",
"description": "Scope"
},
"scopeType": {
"type": "string",
"example": "Server",
"enum": [
"Server",
"ServerGroup"
],
"description": "Scope Type"
}
}
}
Example
{
"UUID": "4f88a7d5-0894-42a0-be90-86e9f5892414",
"port": 535,
"dscp": 15,
"protocol": "Sctp",
"scope": "snowman-noa",
"scopeType": "Server"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/dscpportrules/{uuid}
get /topo/dscpportrules/{uuid}
Returns the configuration details and a set of links for the specified DSCP Port Rule. The links can be used to perform delete or edit operations on the Rule.
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/dscpportruleItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/dscpportrule/dscpportrule.json",
"type": "object",
"required": ["port","dscp","protocol","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"UUID": {
"type": "string",
"description": "DSCP Rule Identifier (*generated*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"port": {
"type": "integer",
"minimum": 1,
"maximum": 65535,
"example": 1556,
"description": "Port"
},
"dscp": {
"type": "integer",
"example": 63,
"minimum": 0,
"maximum": 63,
"description": "The DSCP Value"
},
"protocol": {
"type": "string",
"example": "Tcp",
"enum": [
"Sctp",
"Tcp"
],
"description": "Protocol"
},
"scope": {
"type": "string",
"example": "snowman-noa",
"description": "Scope"
},
"scopeType": {
"type": "string",
"example": "Server",
"enum": [
"Server",
"ServerGroup"
],
"description": "Scope Type"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"UUID": "4f88a7d5-0894-42a0-be90-86e9f5892414",
"port": 535,
"dscp": 15,
"protocol": "Sctp",
"scope": "snowman-noa",
"scopeType": "Server"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /topo/dscpportrules/{uuid}
Deletes a DSCP Port Rule, using a link returned by a previous GET operation.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Topo: Network Devices
Network Devices provide servers access to networks. Network Devices are identified using a port name; they have a type (e.g., Ethernet or VLAN); and they provide access to the server-specific network details such as IP addresses.
Items in the Network Device collection don't have an inherent natural identifier. Each time a new Network Device is created, it is assigned an identifier which is available as the uuid field.
Configuration of Network Devices is only available at the NOAM.
/topo/networkdevices
get /topo/networkdevices
Returns the details for all configured Network Devices that meet the criteria specified in a valid GET request. For DSR networks with a large number of Network Devices(several hundred or more), the time required by the DSR to prepare and send the response to the client can take multiple minutes. It is recommended that clients limit the requested data using the scope_type and scope_name query parameters, to avoid potential client-side request timeouts due to a potentially slow DSR response.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/networkdeviceCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkdevice/networkdevice.json",
"type" :"object",
"required": ["hostname","type","interfaces"],
"notInsertable": ["status","UUID"],
"properties": {
"port": {
"type": "string",
"example": "eth01",
"description": "Device Port"
},
"type": {
"type": "string",
"enum": ["Bonding","Vlan","Alias","Ethernet"],
"example": "Vlan",
"description": "Device Type"
},
"status": {
"type": "string",
"description": "Device configuration status (computed)",
"enum": [
"Configured",
"DeletePending",
"Deployed",
"Discovered",
"EditPending"
]
},
"UUID": {
"type": "string",
"description": "Device Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[a-f0-9]{8}-[a-f0-9]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"hostname": {
"type": "string",
"example": "sans-noa",
"description": "Hostname"
},
"interfaces": {
"type": "array",
"description": "Device Interfaces",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/deviceInterface/deviceInterface.json",
"type" :"object",
"required": ["networkName","ipAddress"],
"properties": {
"networkName": {
"type": "string",
"example": "LAN",
"description": "Network Name"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
},
"minItems": 0
},
"options": {
"type": "object",
"properties": {
"onboot": {
"type": "boolean"
},
"bootProto": {
"type": "string",
"example": "Dhcp",
"enum": [
"Dhcp",
"None"
]
},
"mtu": {
"type": "integer",
"minimum": 1280,
"maximum": 65570
},
"baseDevice": {
"type": "array",
"example": ["eth0"],
"items":
{ "type": "string" },
"minItems": 1
},
"monitorType": {
"type": "string",
"example": "Mii",
"enum": ["Mii","Arp"]
},
"primary": {
"type": "string"
},
"miimon": {
"type": "integer",
"minimum": 1
},
"updelay": {
"type": "integer",
"minimum": 1
},
"downdelay": {
"type": "integer",
"minimum": 1
},
"arpInterval": {
"type": "integer",
"minimum": 1
},
"arpValidate": {
"type": "string",
"example": "Active",
"enum": ["None","Active","Backup","All"]
},
"arpIpTarget": {
"type": "string"
},
"persistentDhclient": {
"type": "boolean",
"readOnly": true
},
"hwAddr": {
"type": "string",
"example": "02:5C:3A:73:05:35",
"readOnly": true,
"pattern": "^[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}$"
},
"ethtoolOpts": {
"type": "string",
"readOnly": true
},
"ethtoolAccelOpts": {
"type": "string",
"readOnly": true
}
}
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"port": "eth0.42",
"type": "Vlan",
"status": "Deployed",
"UUID": "035506de-ef75-49be-ada9-a25b820fc738",
"hostname": "papyrus-noa",
"interfaces": [
{
"ipAddress": "23.16.0.4",
"networkName": "WAN"
}
],
"options": {
"baseDevice": [
"eth0"
],
"mtu": 1500,
"bootProto": "None",
"onboot": true
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/networkdevices
Adds a new Network Device. Using existing networking devices, create a new Network Device. The following Network Device types may be created using this interface:
- Bonding - combine two devices into a single aggregated network interface.
- Vlan - Add a Vlan network interface to a device.
Alias - Add an aliased network interface to a device (add a second IPV4 address).
Ethernet devices cannot be added or deleted - these must preconfigured by the OS.
The POST operation will return the generated uuid for the newly created device.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkdevice/networkdevice.json",
"type" :"object",
"required": ["hostname","type","interfaces"],
"notInsertable": ["status","UUID"],
"properties": {
"port": {
"type": "string",
"example": "eth01",
"description": "Device Port"
},
"type": {
"type": "string",
"enum": ["Bonding","Vlan","Alias","Ethernet"],
"example": "Vlan",
"description": "Device Type"
},
"status": {
"type": "string",
"description": "Device configuration status (computed)",
"enum": [
"Configured",
"DeletePending",
"Deployed",
"Discovered",
"EditPending"
]
},
"UUID": {
"type": "string",
"description": "Device Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[a-f0-9]{8}-[a-f0-9]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"hostname": {
"type": "string",
"example": "sans-noa",
"description": "Hostname"
},
"interfaces": {
"type": "array",
"description": "Device Interfaces",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/deviceInterface/deviceInterface.json",
"type" :"object",
"required": ["networkName","ipAddress"],
"properties": {
"networkName": {
"type": "string",
"example": "LAN",
"description": "Network Name"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
},
"minItems": 0
},
"options": {
"type": "object",
"properties": {
"onboot": {
"type": "boolean"
},
"bootProto": {
"type": "string",
"example": "Dhcp",
"enum": [
"Dhcp",
"None"
]
},
"mtu": {
"type": "integer",
"minimum": 1280,
"maximum": 65570
},
"baseDevice": {
"type": "array",
"example": ["eth0"],
"items":
{ "type": "string" },
"minItems": 1
},
"monitorType": {
"type": "string",
"example": "Mii",
"enum": ["Mii","Arp"]
},
"primary": {
"type": "string"
},
"miimon": {
"type": "integer",
"minimum": 1
},
"updelay": {
"type": "integer",
"minimum": 1
},
"downdelay": {
"type": "integer",
"minimum": 1
},
"arpInterval": {
"type": "integer",
"minimum": 1
},
"arpValidate": {
"type": "string",
"example": "Active",
"enum": ["None","Active","Backup","All"]
},
"arpIpTarget": {
"type": "string"
},
"persistentDhclient": {
"type": "boolean",
"readOnly": true
},
"hwAddr": {
"type": "string",
"example": "02:5C:3A:73:05:35",
"readOnly": true,
"pattern": "^[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}$"
},
"ethtoolOpts": {
"type": "string",
"readOnly": true
},
"ethtoolAccelOpts": {
"type": "string",
"readOnly": true
}
}
}
}
}
Example
{
"port": "eth0.42",
"type": "Vlan",
"status": "Deployed",
"UUID": "035506de-ef75-49be-ada9-a25b820fc738",
"hostname": "papyrus-noa",
"interfaces": [
{
"ipAddress": "23.16.0.4",
"networkName": "WAN"
}
],
"options": {
"baseDevice": [
"eth0"
],
"mtu": 1500,
"bootProto": "None",
"onboot": true
}
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/networkdevices/{uuid}
get /topo/networkdevices/{uuid}
Returns the configuration details and a set of links for the specified Network Device. The links can be used to perform delete or edit operations on the Network Device.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/networkdeviceItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkdevice/networkdevice.json",
"type" :"object",
"required": ["hostname","type","interfaces"],
"notInsertable": ["status","UUID"],
"properties": {
"port": {
"type": "string",
"example": "eth01",
"description": "Device Port"
},
"type": {
"type": "string",
"enum": ["Bonding","Vlan","Alias","Ethernet"],
"example": "Vlan",
"description": "Device Type"
},
"status": {
"type": "string",
"description": "Device configuration status (computed)",
"enum": [
"Configured",
"DeletePending",
"Deployed",
"Discovered",
"EditPending"
]
},
"UUID": {
"type": "string",
"description": "Device Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[a-f0-9]{8}-[a-f0-9]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"hostname": {
"type": "string",
"example": "sans-noa",
"description": "Hostname"
},
"interfaces": {
"type": "array",
"description": "Device Interfaces",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/deviceInterface/deviceInterface.json",
"type" :"object",
"required": ["networkName","ipAddress"],
"properties": {
"networkName": {
"type": "string",
"example": "LAN",
"description": "Network Name"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
},
"minItems": 0
},
"options": {
"type": "object",
"properties": {
"onboot": {
"type": "boolean"
},
"bootProto": {
"type": "string",
"example": "Dhcp",
"enum": [
"Dhcp",
"None"
]
},
"mtu": {
"type": "integer",
"minimum": 1280,
"maximum": 65570
},
"baseDevice": {
"type": "array",
"example": ["eth0"],
"items":
{ "type": "string" },
"minItems": 1
},
"monitorType": {
"type": "string",
"example": "Mii",
"enum": ["Mii","Arp"]
},
"primary": {
"type": "string"
},
"miimon": {
"type": "integer",
"minimum": 1
},
"updelay": {
"type": "integer",
"minimum": 1
},
"downdelay": {
"type": "integer",
"minimum": 1
},
"arpInterval": {
"type": "integer",
"minimum": 1
},
"arpValidate": {
"type": "string",
"example": "Active",
"enum": ["None","Active","Backup","All"]
},
"arpIpTarget": {
"type": "string"
},
"persistentDhclient": {
"type": "boolean",
"readOnly": true
},
"hwAddr": {
"type": "string",
"example": "02:5C:3A:73:05:35",
"readOnly": true,
"pattern": "^[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}$"
},
"ethtoolOpts": {
"type": "string",
"readOnly": true
},
"ethtoolAccelOpts": {
"type": "string",
"readOnly": true
}
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"port": "eth0.42",
"type": "Vlan",
"status": "Deployed",
"UUID": "035506de-ef75-49be-ada9-a25b820fc738",
"hostname": "papyrus-noa",
"interfaces": [
{
"ipAddress": "23.16.0.4",
"networkName": "WAN"
}
],
"options": {
"baseDevice": [
"eth0"
],
"mtu": 1500,
"bootProto": "None",
"onboot": true
}
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/networkdevices/{uuid}
Updates the Network Device details.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkdevice/networkdevice.json",
"type" :"object",
"required": ["hostname","type","interfaces"],
"notInsertable": ["status","UUID"],
"properties": {
"port": {
"type": "string",
"example": "eth01",
"description": "Device Port"
},
"type": {
"type": "string",
"enum": ["Bonding","Vlan","Alias","Ethernet"],
"example": "Vlan",
"description": "Device Type"
},
"status": {
"type": "string",
"description": "Device configuration status (computed)",
"enum": [
"Configured",
"DeletePending",
"Deployed",
"Discovered",
"EditPending"
]
},
"UUID": {
"type": "string",
"description": "Device Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[a-f0-9]{8}-[a-f0-9]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"hostname": {
"type": "string",
"example": "sans-noa",
"description": "Hostname"
},
"interfaces": {
"type": "array",
"description": "Device Interfaces",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/deviceInterface/deviceInterface.json",
"type" :"object",
"required": ["networkName","ipAddress"],
"properties": {
"networkName": {
"type": "string",
"example": "LAN",
"description": "Network Name"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
},
"minItems": 0
},
"options": {
"type": "object",
"properties": {
"onboot": {
"type": "boolean"
},
"bootProto": {
"type": "string",
"example": "Dhcp",
"enum": [
"Dhcp",
"None"
]
},
"mtu": {
"type": "integer",
"minimum": 1280,
"maximum": 65570
},
"baseDevice": {
"type": "array",
"example": ["eth0"],
"items":
{ "type": "string" },
"minItems": 1
},
"monitorType": {
"type": "string",
"example": "Mii",
"enum": ["Mii","Arp"]
},
"primary": {
"type": "string"
},
"miimon": {
"type": "integer",
"minimum": 1
},
"updelay": {
"type": "integer",
"minimum": 1
},
"downdelay": {
"type": "integer",
"minimum": 1
},
"arpInterval": {
"type": "integer",
"minimum": 1
},
"arpValidate": {
"type": "string",
"example": "Active",
"enum": ["None","Active","Backup","All"]
},
"arpIpTarget": {
"type": "string"
},
"persistentDhclient": {
"type": "boolean",
"readOnly": true
},
"hwAddr": {
"type": "string",
"example": "02:5C:3A:73:05:35",
"readOnly": true,
"pattern": "^[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}$"
},
"ethtoolOpts": {
"type": "string",
"readOnly": true
},
"ethtoolAccelOpts": {
"type": "string",
"readOnly": true
}
}
}
}
}
Example
{
"port": "eth0.42",
"type": "Vlan",
"status": "Deployed",
"UUID": "035506de-ef75-49be-ada9-a25b820fc738",
"hostname": "papyrus-noa",
"interfaces": [
{
"ipAddress": "23.16.0.4",
"networkName": "WAN"
}
],
"options": {
"baseDevice": [
"eth0"
],
"mtu": 1500,
"bootProto": "None",
"onboot": true
}
}
delete /topo/networkdevices/{uuid}
Deletes the Network Device, using a link returned by a previous GET operation.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
/topo/networkdevices/discovered
get /topo/networkdevices/discovered
Returns the details for discovered Network Devices that meet the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/networkdeviceCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkdevice/networkdevice.json",
"type" :"object",
"required": ["hostname","type","interfaces"],
"notInsertable": ["status","UUID"],
"properties": {
"port": {
"type": "string",
"example": "eth01",
"description": "Device Port"
},
"type": {
"type": "string",
"enum": ["Bonding","Vlan","Alias","Ethernet"],
"example": "Vlan",
"description": "Device Type"
},
"status": {
"type": "string",
"description": "Device configuration status (computed)",
"enum": [
"Configured",
"DeletePending",
"Deployed",
"Discovered",
"EditPending"
]
},
"UUID": {
"type": "string",
"description": "Device Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[a-f0-9]{8}-[a-f0-9]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"hostname": {
"type": "string",
"example": "sans-noa",
"description": "Hostname"
},
"interfaces": {
"type": "array",
"description": "Device Interfaces",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/deviceInterface/deviceInterface.json",
"type" :"object",
"required": ["networkName","ipAddress"],
"properties": {
"networkName": {
"type": "string",
"example": "LAN",
"description": "Network Name"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
},
"minItems": 0
},
"options": {
"type": "object",
"properties": {
"onboot": {
"type": "boolean"
},
"bootProto": {
"type": "string",
"example": "Dhcp",
"enum": [
"Dhcp",
"None"
]
},
"mtu": {
"type": "integer",
"minimum": 1280,
"maximum": 65570
},
"baseDevice": {
"type": "array",
"example": ["eth0"],
"items":
{ "type": "string" },
"minItems": 1
},
"monitorType": {
"type": "string",
"example": "Mii",
"enum": ["Mii","Arp"]
},
"primary": {
"type": "string"
},
"miimon": {
"type": "integer",
"minimum": 1
},
"updelay": {
"type": "integer",
"minimum": 1
},
"downdelay": {
"type": "integer",
"minimum": 1
},
"arpInterval": {
"type": "integer",
"minimum": 1
},
"arpValidate": {
"type": "string",
"example": "Active",
"enum": ["None","Active","Backup","All"]
},
"arpIpTarget": {
"type": "string"
},
"persistentDhclient": {
"type": "boolean",
"readOnly": true
},
"hwAddr": {
"type": "string",
"example": "02:5C:3A:73:05:35",
"readOnly": true,
"pattern": "^[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}$"
},
"ethtoolOpts": {
"type": "string",
"readOnly": true
},
"ethtoolAccelOpts": {
"type": "string",
"readOnly": true
}
}
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"port": "eth0.42",
"type": "Vlan",
"status": "Deployed",
"UUID": "035506de-ef75-49be-ada9-a25b820fc738",
"hostname": "papyrus-noa",
"interfaces": [
{
"ipAddress": "23.16.0.4",
"networkName": "WAN"
}
],
"options": {
"baseDevice": [
"eth0"
],
"mtu": 1500,
"bootProto": "None",
"onboot": true
}
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/networkdevices/discovered/{uuid}
get /topo/networkdevices/discovered/{uuid}
Returns the details and a set of link for discovered Network devices. The link can be used to perform an edit operation on the Network Device.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/networkdeviceItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkdevice/networkdevice.json",
"type" :"object",
"required": ["hostname","type","interfaces"],
"notInsertable": ["status","UUID"],
"properties": {
"port": {
"type": "string",
"example": "eth01",
"description": "Device Port"
},
"type": {
"type": "string",
"enum": ["Bonding","Vlan","Alias","Ethernet"],
"example": "Vlan",
"description": "Device Type"
},
"status": {
"type": "string",
"description": "Device configuration status (computed)",
"enum": [
"Configured",
"DeletePending",
"Deployed",
"Discovered",
"EditPending"
]
},
"UUID": {
"type": "string",
"description": "Device Identifier (generated)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[a-f0-9]{8}-[a-f0-9]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"hostname": {
"type": "string",
"example": "sans-noa",
"description": "Hostname"
},
"interfaces": {
"type": "array",
"description": "Device Interfaces",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/deviceInterface/deviceInterface.json",
"type" :"object",
"required": ["networkName","ipAddress"],
"properties": {
"networkName": {
"type": "string",
"example": "LAN",
"description": "Network Name"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
},
"minItems": 0
},
"options": {
"type": "object",
"properties": {
"onboot": {
"type": "boolean"
},
"bootProto": {
"type": "string",
"example": "Dhcp",
"enum": [
"Dhcp",
"None"
]
},
"mtu": {
"type": "integer",
"minimum": 1280,
"maximum": 65570
},
"baseDevice": {
"type": "array",
"example": ["eth0"],
"items":
{ "type": "string" },
"minItems": 1
},
"monitorType": {
"type": "string",
"example": "Mii",
"enum": ["Mii","Arp"]
},
"primary": {
"type": "string"
},
"miimon": {
"type": "integer",
"minimum": 1
},
"updelay": {
"type": "integer",
"minimum": 1
},
"downdelay": {
"type": "integer",
"minimum": 1
},
"arpInterval": {
"type": "integer",
"minimum": 1
},
"arpValidate": {
"type": "string",
"example": "Active",
"enum": ["None","Active","Backup","All"]
},
"arpIpTarget": {
"type": "string"
},
"persistentDhclient": {
"type": "boolean",
"readOnly": true
},
"hwAddr": {
"type": "string",
"example": "02:5C:3A:73:05:35",
"readOnly": true,
"pattern": "^[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}:[A-F0-9]{2}$"
},
"ethtoolOpts": {
"type": "string",
"readOnly": true
},
"ethtoolAccelOpts": {
"type": "string",
"readOnly": true
}
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"port": "eth0.42",
"type": "Vlan",
"status": "Deployed",
"UUID": "035506de-ef75-49be-ada9-a25b820fc738",
"hostname": "papyrus-noa",
"interfaces": [
{
"ipAddress": "23.16.0.4",
"networkName": "WAN"
}
],
"options": {
"baseDevice": [
"eth0"
],
"mtu": 1500,
"bootProto": "None",
"onboot": true
}
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/networkdevices/discovered/{uuid}
The PUT operation allows a client to take ownership of a discovered Network Device. Using the details returned by a previous GET operation, the PUT operation allows a discovered device to be recharacterized as a configured device. The client can use the Network Devices URI (/topo/networkdevices) to retrieve the configured Network Device.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/update/update.json",
"type" :"object",
"required": [
],
"properties": {
}
}
Example
{
}
Topo: Network Elements
A Network Element is a common set of networking configurations that several servers may share. Typically, all the the servers sharing the Network Element configuration are located at the same site. The name field is the natural identifier for this collection.
Configuration of Network Elements is only available at the NOAM.
/topo/networkelements
get /topo/networkelements
Retrieves configuration data for all Network Elements that meet the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/networkelementCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkelement/networkelement.json",
"type": "object",
"required": ["name"],
"properties": {
"name": {
"type": "string",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"example": "NO_NE",
"description": "Network Element Name"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "NO_NE"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/networkelements
Adds a new Network Element. The name field is the identifier and is returned by the POST operation.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkelement/networkelement.json",
"type": "object",
"required": ["name"],
"properties": {
"name": {
"type": "string",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"example": "NO_NE",
"description": "Network Element Name"
}
}
}
Example
{
"name": "NO_NE"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/networkelements/{name}
get /topo/networkelements/{name}
Returns the configuration details for the specified Network Element.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/networkelementItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkelement/networkelement.json",
"type": "object",
"required": ["name"],
"properties": {
"name": {
"type": "string",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"example": "NO_NE",
"description": "Network Element Name"
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "NO_NE"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
delete /topo/networkelements/{name}
Deletes the specified Network Element. Note that a Network Element can only be deleted if it has no children.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/topo/networkelements/{name}/monitor
get /topo/networkelements/{name}/monitor
Retrieves the router monitoring status for the named Network Element.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkelement/nemonitor.json",
"type": "object",
"required": ["ping"],
"properties": {
"ping": {
"description": "Router Monitor Ping",
"enum": [ "Enabled", "Disabled" ],
"example": "Enabled"
}
}
}
Example
{
"ping": "Enabled"
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/networkelements/{name}/monitor
Manages the router monitoring for a Network Element.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkelement/nemonitor.json",
"type": "object",
"required": ["ping"],
"properties": {
"ping": {
"description": "Router Monitor Ping",
"enum": [ "Enabled", "Disabled" ],
"example": "Enabled"
}
}
}
Example
{
"ping": "Enabled"
}
Topo: Network Routes
Network Routes are used to direct network traffic between servers. Routes may be added for both IPV6 and IPV4 networks. Items in the Network Route collection don't have a natural identifier. Each time a new Route is created, it is assigned an identifier which is available as the uuid field.
Configuration of network routes is only available at the NOAM.
/topo/networkroutes
get /topo/networkroutes
Returns the configuration data for all Network Routes that meet the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/networkrouteCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkroute/networkroute.json",
"type": "object",
"required": ["type","port","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"hostname": {
"type": "string",
"description": "Hostname"
},
"UUID": {
"type": "string",
"description": "Route Identifier",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"type": {
"type": "string",
"enum": [
"Default",
"Host",
"Net"
]
},
"port": {
"type": "string",
"description": "Device name"
},
"networkAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"scope": {
"type": "string",
"description": "Route Scope"
},
"scopeType": {
"type": "string",
"enum": [
"Server",
"ServerGroup"
]
},
"status": {
"type": "string",
"description": "Configuration status (computed)",
"enum": ["Deployed","Discovered","Configured"]
},
"statusDetails": {
"type": "string",
"description": "Additional status details (computed)",
"example": "Route deployed to 12 of 34 servers"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"hostname": "mettaton-noa",
"UUID": "2c7abb61-0fb2-4d10-848f-17778b1b005b",
"type": "Net",
"port": "eth0.3000",
"networkAddress": "42.42.43.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "4.3.2.1",
"scope": "mettaton-noa",
"scopeType": "Server",
"status": "Deployed"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/networkroutes
Adds a new Network Route, allowing a Route to be associated with either a Server or a Server Group. The generated uuid is returned.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkroute/networkroute.json",
"type": "object",
"required": ["type","port","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"hostname": {
"type": "string",
"description": "Hostname"
},
"UUID": {
"type": "string",
"description": "Route Identifier",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"type": {
"type": "string",
"enum": [
"Default",
"Host",
"Net"
]
},
"port": {
"type": "string",
"description": "Device name"
},
"networkAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"scope": {
"type": "string",
"description": "Route Scope"
},
"scopeType": {
"type": "string",
"enum": [
"Server",
"ServerGroup"
]
},
"status": {
"type": "string",
"description": "Configuration status (computed)",
"enum": ["Deployed","Discovered","Configured"]
},
"statusDetails": {
"type": "string",
"description": "Additional status details (computed)",
"example": "Route deployed to 12 of 34 servers"
}
}
}
Example
{
"hostname": "mettaton-noa",
"UUID": "2c7abb61-0fb2-4d10-848f-17778b1b005b",
"type": "Net",
"port": "eth0.3000",
"networkAddress": "42.42.43.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "4.3.2.1",
"scope": "mettaton-noa",
"scopeType": "Server",
"status": "Deployed"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/networkroutes/{uuid}
get /topo/networkroutes/{uuid}
Returns the configuration details for the specified Network Route.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/networkrouteItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkroute/networkroute.json",
"type": "object",
"required": ["type","port","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"hostname": {
"type": "string",
"description": "Hostname"
},
"UUID": {
"type": "string",
"description": "Route Identifier",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"type": {
"type": "string",
"enum": [
"Default",
"Host",
"Net"
]
},
"port": {
"type": "string",
"description": "Device name"
},
"networkAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"scope": {
"type": "string",
"description": "Route Scope"
},
"scopeType": {
"type": "string",
"enum": [
"Server",
"ServerGroup"
]
},
"status": {
"type": "string",
"description": "Configuration status (computed)",
"enum": ["Deployed","Discovered","Configured"]
},
"statusDetails": {
"type": "string",
"description": "Additional status details (computed)",
"example": "Route deployed to 12 of 34 servers"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"hostname": "mettaton-noa",
"UUID": "2c7abb61-0fb2-4d10-848f-17778b1b005b",
"type": "Net",
"port": "eth0.3000",
"networkAddress": "42.42.43.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "4.3.2.1",
"scope": "mettaton-noa",
"scopeType": "Server",
"status": "Deployed"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/networkroutes/{uuid}
Updates the Network Route details.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkroute/networkroute.json",
"type": "object",
"required": ["type","port","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"hostname": {
"type": "string",
"description": "Hostname"
},
"UUID": {
"type": "string",
"description": "Route Identifier",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"type": {
"type": "string",
"enum": [
"Default",
"Host",
"Net"
]
},
"port": {
"type": "string",
"description": "Device name"
},
"networkAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"scope": {
"type": "string",
"description": "Route Scope"
},
"scopeType": {
"type": "string",
"enum": [
"Server",
"ServerGroup"
]
},
"status": {
"type": "string",
"description": "Configuration status (computed)",
"enum": ["Deployed","Discovered","Configured"]
},
"statusDetails": {
"type": "string",
"description": "Additional status details (computed)",
"example": "Route deployed to 12 of 34 servers"
}
}
}
Example
{
"hostname": "mettaton-noa",
"UUID": "2c7abb61-0fb2-4d10-848f-17778b1b005b",
"type": "Net",
"port": "eth0.3000",
"networkAddress": "42.42.43.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "4.3.2.1",
"scope": "mettaton-noa",
"scopeType": "Server",
"status": "Deployed"
}
delete /topo/networkroutes/{uuid}
Deletes a Network Route.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
/topo/networkroutes/discovered
get /topo/networkroutes/discovered
Returns all discovered Network Routes that meet the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/networkrouteCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkroute/networkroute.json",
"type": "object",
"required": ["type","port","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"hostname": {
"type": "string",
"description": "Hostname"
},
"UUID": {
"type": "string",
"description": "Route Identifier",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"type": {
"type": "string",
"enum": [
"Default",
"Host",
"Net"
]
},
"port": {
"type": "string",
"description": "Device name"
},
"networkAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"scope": {
"type": "string",
"description": "Route Scope"
},
"scopeType": {
"type": "string",
"enum": [
"Server",
"ServerGroup"
]
},
"status": {
"type": "string",
"description": "Configuration status (computed)",
"enum": ["Deployed","Discovered","Configured"]
},
"statusDetails": {
"type": "string",
"description": "Additional status details (computed)",
"example": "Route deployed to 12 of 34 servers"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"hostname": "mettaton-noa",
"UUID": "2c7abb61-0fb2-4d10-848f-17778b1b005b",
"type": "Net",
"port": "eth0.3000",
"networkAddress": "42.42.43.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "4.3.2.1",
"scope": "mettaton-noa",
"scopeType": "Server",
"status": "Deployed"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/networkroutes/discovered/{uuid}
get /topo/networkroutes/discovered/{uuid}
Returns the details for the specified discovered Network Route.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/networkrouteItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/networkroute/networkroute.json",
"type": "object",
"required": ["type","port","scope","scopeType"],
"notInsertable": ["UUID"],
"properties": {
"hostname": {
"type": "string",
"description": "Hostname"
},
"UUID": {
"type": "string",
"description": "Route Identifier",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$|^([A-Za-z0-9=]+)$"
},
"type": {
"type": "string",
"enum": [
"Default",
"Host",
"Net"
]
},
"port": {
"type": "string",
"description": "Device name"
},
"networkAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"scope": {
"type": "string",
"description": "Route Scope"
},
"scopeType": {
"type": "string",
"enum": [
"Server",
"ServerGroup"
]
},
"status": {
"type": "string",
"description": "Configuration status (computed)",
"enum": ["Deployed","Discovered","Configured"]
},
"statusDetails": {
"type": "string",
"description": "Additional status details (computed)",
"example": "Route deployed to 12 of 34 servers"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"hostname": "mettaton-noa",
"UUID": "2c7abb61-0fb2-4d10-848f-17778b1b005b",
"type": "Net",
"port": "eth0.3000",
"networkAddress": "42.42.43.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "4.3.2.1",
"scope": "mettaton-noa",
"scopeType": "Server",
"status": "Deployed"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/networkroutes/discovered/{uuid}
Using the details returned by a previous GET operation, the PUT operation allows a discovered Network Route to be recharacterized as a configured Network Route. The client can use the Network Routes URI (/topo/networkroutes) to retrieve the configured Network Route.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/update/update.json",
"type" :"object",
"required": [
],
"properties": {
}
}
Example
{
}
Topo: Networks
A Network is used to name a collection of network related data. Networks sharing the same name are typical and expected as the network names are used when defining service paths. Items in the Network collection don't have a natural identifier. Each time a new Network is created, it is assigned an identifier which is available as the uuid field.
Configuration of networks is only available at the NOAM.
/topo/networks
get /topo/networks
Returns the configuration details for all configured Networks.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/networkCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/network/network.json",
"type" :"object",
"required": ["name", "vlanId", "ipAddress", "subnetMask"],
"notInsertable": ["UUID"],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9]*$",
"maxLength": 31,
"example": "LAN",
"description": "Network Name"
},
"UUID": {
"type": "string",
"description": "Network Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"neName": {
"type": "string",
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"example": "NO_NE",
"description": "Network Element Name"
},
"type": {
"enum": [
"Application",
"Oam"
],
"example": "Oam",
"description": "Network Type"
},
"vlanId": {
"type": "integer",
"minimum": 0,
"maximum": 4094,
"example": 123,
"description": "VLAN ID for this Network"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"isDefault": {
"type": "boolean",
"example": true,
"description": "Is Default Gateway"
},
"isRoutable": {
"type": "boolean",
"example": true,
"description": "Is Routable"
},
"locked": {
"type": "boolean",
"example": false,
"description": "Locked"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "WAN",
"UUID": "445b8667-bd22-45fd-adfd-c6fa5032819f",
"neName": "NO_NE",
"type": "Oam",
"vlanId": 38,
"ipAddress": "23.55.0.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "23.55.0.1",
"isDefault": true,
"isRoutable": true,
"locked": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/networks
Adds a new Network to the configuration. The generated uuid field is returned.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/network/network.json",
"type" :"object",
"required": ["name", "vlanId", "ipAddress", "subnetMask"],
"notInsertable": ["UUID"],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9]*$",
"maxLength": 31,
"example": "LAN",
"description": "Network Name"
},
"UUID": {
"type": "string",
"description": "Network Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"neName": {
"type": "string",
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"example": "NO_NE",
"description": "Network Element Name"
},
"type": {
"enum": [
"Application",
"Oam"
],
"example": "Oam",
"description": "Network Type"
},
"vlanId": {
"type": "integer",
"minimum": 0,
"maximum": 4094,
"example": 123,
"description": "VLAN ID for this Network"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"isDefault": {
"type": "boolean",
"example": true,
"description": "Is Default Gateway"
},
"isRoutable": {
"type": "boolean",
"example": true,
"description": "Is Routable"
},
"locked": {
"type": "boolean",
"example": false,
"description": "Locked"
}
}
}
Example
{
"name": "WAN",
"UUID": "445b8667-bd22-45fd-adfd-c6fa5032819f",
"neName": "NO_NE",
"type": "Oam",
"vlanId": 38,
"ipAddress": "23.55.0.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "23.55.0.1",
"isDefault": true,
"isRoutable": true,
"locked": true
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/networks/{uuid}
get /topo/networks/{uuid}
Returns the configuration details for the specified Network.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/networkItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/network/network.json",
"type" :"object",
"required": ["name", "vlanId", "ipAddress", "subnetMask"],
"notInsertable": ["UUID"],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9]*$",
"maxLength": 31,
"example": "LAN",
"description": "Network Name"
},
"UUID": {
"type": "string",
"description": "Network Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"neName": {
"type": "string",
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"example": "NO_NE",
"description": "Network Element Name"
},
"type": {
"enum": [
"Application",
"Oam"
],
"example": "Oam",
"description": "Network Type"
},
"vlanId": {
"type": "integer",
"minimum": 0,
"maximum": 4094,
"example": 123,
"description": "VLAN ID for this Network"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"isDefault": {
"type": "boolean",
"example": true,
"description": "Is Default Gateway"
},
"isRoutable": {
"type": "boolean",
"example": true,
"description": "Is Routable"
},
"locked": {
"type": "boolean",
"example": false,
"description": "Locked"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "WAN",
"UUID": "445b8667-bd22-45fd-adfd-c6fa5032819f",
"neName": "NO_NE",
"type": "Oam",
"vlanId": 38,
"ipAddress": "23.55.0.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "23.55.0.1",
"isDefault": true,
"isRoutable": true,
"locked": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/networks/{uuid}
Updates the specified Network.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/network/network.json",
"type" :"object",
"required": ["name", "vlanId", "ipAddress", "subnetMask"],
"notInsertable": ["UUID"],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9]*$",
"maxLength": 31,
"example": "LAN",
"description": "Network Name"
},
"UUID": {
"type": "string",
"description": "Network Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"neName": {
"type": "string",
"pattern": "^$|^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"example": "NO_NE",
"description": "Network Element Name"
},
"type": {
"enum": [
"Application",
"Oam"
],
"example": "Oam",
"description": "Network Type"
},
"vlanId": {
"type": "integer",
"minimum": 0,
"maximum": 4094,
"example": 123,
"description": "VLAN ID for this Network"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"subnetMask":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6NetMask/IPv4orIPv6NetMask.json",
"type": "string",
"pattern": "^(((1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}(1?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^/[0-9]{1,3}$",
"example": "/24"
},
"gatewayAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"isDefault": {
"type": "boolean",
"example": true,
"description": "Is Default Gateway"
},
"isRoutable": {
"type": "boolean",
"example": true,
"description": "Is Routable"
},
"locked": {
"type": "boolean",
"example": false,
"description": "Locked"
}
}
}
Example
{
"name": "WAN",
"UUID": "445b8667-bd22-45fd-adfd-c6fa5032819f",
"neName": "NO_NE",
"type": "Oam",
"vlanId": 38,
"ipAddress": "23.55.0.0",
"subnetMask": "255.255.255.0",
"gatewayAddress": "23.55.0.1",
"isDefault": true,
"isRoutable": true,
"locked": true
}
delete /topo/networks/{uuid}
Deletes the specified Network.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- uuid: required (string)
Topo: Network Service Paths
Service Paths are used to segregate traffic of a defined category on to a specified set of networks. Each distinct Service Path is identified using a preconfigured collection name.
Configuration of Service Paths is only available at the NOAM.
/topo/servicepaths
get /topo/servicepaths
Returns all the the configured Service Paths that meet the request parameters, for each predefined category.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/servicepathCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servicepath/servicepath.json",
"type": "object",
"required": ["name","intraSitePath","interSitePath"],
"properties": {
"name": {
"type": "string",
"description": "Name of Service"
},
"intraSitePath": {
"type": "string",
"description": "Intra-NE Network"
},
"interSitePath": {
"type": "string",
"description": "Inter-NE Network"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "OAM",
"intraSitePath": "LAN",
"interSitePath": "WAN"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/servicepaths/{name}
get /topo/servicepaths/{name}
Returns the configuration details for the specified Service Path.
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/servicepathItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servicepath/servicepath.json",
"type": "object",
"required": ["name","intraSitePath","interSitePath"],
"properties": {
"name": {
"type": "string",
"description": "Name of Service"
},
"intraSitePath": {
"type": "string",
"description": "Intra-NE Network"
},
"interSitePath": {
"type": "string",
"description": "Inter-NE Network"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "OAM",
"intraSitePath": "LAN",
"interSitePath": "WAN"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/servicepaths/{name}
Updates the specified Service Path. The list of suitable intraSitePath and interSitePath settings can be found by making a call to GET /topo/networks GET and finding the name fields.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servicepath/servicepath.json",
"type": "object",
"required": ["name","intraSitePath","interSitePath"],
"properties": {
"name": {
"type": "string",
"description": "Name of Service"
},
"intraSitePath": {
"type": "string",
"description": "Intra-NE Network"
},
"interSitePath": {
"type": "string",
"description": "Inter-NE Network"
}
}
}
Example
{
"name": "OAM",
"intraSitePath": "LAN",
"interSitePath": "WAN"
}
Topo: Places
Places are used to define server location details. Places can be defined to act as parents for other Places, thus allowing hierarchical relationships to be defined (e.g., Earth -> North America -> United States -> Illinois -> Chicago). The Place name is the natural identifier for this collection.
Configuration of Places is only available at the NOAM.
/topo/places
get /topo/places
Returns the details for all configured Places.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/placeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/place/place.json",
"type": "object",
"required": ["name","typeName","serverList"],
"properties": {
"name": {
"type": "string",
"description": "Place Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"parentPlaceName": {
"type": "string",
"description": "Parent (not updatable)"
},
"typeName": {
"type": "string",
"description": "Type of Place (not updatable)"
},
"serverList": {
"type": "array",
"description": "Servers in Place",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "Winters",
"parentPlaceName": "Foggyland",
"typeName": "Site",
"serverList": [
"snowman-noa",
"snowman-soa1",
"snowman-so1mp1"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/places
Adds a new Place. The name field is returned as the instance identifier.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/place/place.json",
"type": "object",
"required": ["name","typeName","serverList"],
"properties": {
"name": {
"type": "string",
"description": "Place Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"parentPlaceName": {
"type": "string",
"description": "Parent (not updatable)"
},
"typeName": {
"type": "string",
"description": "Type of Place (not updatable)"
},
"serverList": {
"type": "array",
"description": "Servers in Place",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
Example
{
"name": "Winters",
"parentPlaceName": "Foggyland",
"typeName": "Site",
"serverList": [
"snowman-noa",
"snowman-soa1",
"snowman-so1mp1"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/places/types
get /topo/places/types
Returns all available Place Types.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/optionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/option/option.json",
"type" :"string"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
"Profile 1"
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/places/{name}
get /topo/places/{name}
Returns the configuration details for the specified Place.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/placeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/place/place.json",
"type": "object",
"required": ["name","typeName","serverList"],
"properties": {
"name": {
"type": "string",
"description": "Place Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"parentPlaceName": {
"type": "string",
"description": "Parent (not updatable)"
},
"typeName": {
"type": "string",
"description": "Type of Place (not updatable)"
},
"serverList": {
"type": "array",
"description": "Servers in Place",
"items": {
"type": "string"
},
"minItems": 0
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "Winters",
"parentPlaceName": "Foggyland",
"typeName": "Site",
"serverList": [
"snowman-noa",
"snowman-soa1",
"snowman-so1mp1"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/places/{name}
Updates a Place.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/place/place.json",
"type": "object",
"required": ["name","typeName","serverList"],
"properties": {
"name": {
"type": "string",
"description": "Place Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"parentPlaceName": {
"type": "string",
"description": "Parent (not updatable)"
},
"typeName": {
"type": "string",
"description": "Type of Place (not updatable)"
},
"serverList": {
"type": "array",
"description": "Servers in Place",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
Example
{
"name": "Winters",
"parentPlaceName": "Foggyland",
"typeName": "Site",
"serverList": [
"snowman-noa",
"snowman-soa1",
"snowman-so1mp1"
]
}
delete /topo/places/{name}
Deletes the specified Place. Note that a Place can only be deleted if it has no children.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Topo: Place Associations
The configuration data for all Place Associations. Place Associations classify and name a relationship between two Places. The Place Association name is the natural identifier for this collection.
Configuration of Place Associations is only available at the NOAM.
/topo/placeassociations
get /topo/placeassociations
Returns the details for all configured Place Associations.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/placeassociationCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/placeassociation/placeassociation.json",
"type" :"object",
"required": ["name","typeName","placeList"],
"properties": {
"name": {
"type": "string",
"description": "Place Association Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"typeName": {
"type": "string",
"description": "Type of Place Association"
},
"placeList": {
"type": "array",
"description": "Place in Association",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "austria",
"typeName": "ALEXA Related Region",
"placeList": [
"vienna"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/placeassociations
Adds a new Place Association to the configuration. The name field is returned as the instance identifier.
Target Server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/placeassociation/placeassociation.json",
"type" :"object",
"required": ["name","typeName","placeList"],
"properties": {
"name": {
"type": "string",
"description": "Place Association Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"typeName": {
"type": "string",
"description": "Type of Place Association"
},
"placeList": {
"type": "array",
"description": "Place in Association",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
Example
{
"name": "austria",
"typeName": "ALEXA Related Region",
"placeList": [
"vienna"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/placeassociations/types
get /topo/placeassociations/types
Returns all of the available Place Association Types.
Target Server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/optionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/option/option.json",
"type" :"string"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
"Profile 1"
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/placeassociations/{name}
get /topo/placeassociations/{name}
Returns the configuration details for the specified Place Association.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/placeassociationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/placeassociation/placeassociation.json",
"type" :"object",
"required": ["name","typeName","placeList"],
"properties": {
"name": {
"type": "string",
"description": "Place Association Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"typeName": {
"type": "string",
"description": "Type of Place Association"
},
"placeList": {
"type": "array",
"description": "Place in Association",
"items": {
"type": "string"
},
"minItems": 0
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "austria",
"typeName": "ALEXA Related Region",
"placeList": [
"vienna"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/placeassociations/{name}
Updates a Place Association.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/placeassociation/placeassociation.json",
"type" :"object",
"required": ["name","typeName","placeList"],
"properties": {
"name": {
"type": "string",
"description": "Place Association Name",
"pattern": "^[A-Za-z0-9_ -]+$",
"maxLength": 32
},
"typeName": {
"type": "string",
"description": "Type of Place Association"
},
"placeList": {
"type": "array",
"description": "Place in Association",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
Example
{
"name": "austria",
"typeName": "ALEXA Related Region",
"placeList": [
"vienna"
]
}
delete /topo/placeassociations/{name}
Deletes the specified Place Association.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Topo: Resource Domains
Resource Domains define a named collection of Server Groups implementing predefined availability profiles. Each Resource Domain is uniquely identified using its name field.
Configuration of Resource Ddomains is only available at the NOAM.
/topo/resourcedomains
get /topo/resourcedomains
Returns the details for all configured Resource Domains, listing defined Server Groups and predefined availability profiles.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/resourcedomainCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/resourcedomain/resourcedomain.json",
"type": "object",
"required": ["name","sgNames"],
"properties": {
"name": {
"type": "string",
"description": "Resource Domain Name",
"pattern": "^[A-Za-z0-9_]+$",
"maxLength": 32
},
"profileName": {
"type": "string",
"description": "Profile"
},
"sgNames": {
"type": "array",
"description": "Server Groups in Domain",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "the_lab",
"profileName": "NONE",
"sgNames": [
"NO_SG",
"SO_SG1",
"SO1MP_SG1"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/resourcedomains
Adds a new Resource Domain, associating it with a set of Server Groups and a named availability profile. The name field is the instance identifier and is returned in the POST response.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/resourcedomain/resourcedomain.json",
"type": "object",
"required": ["name","sgNames"],
"properties": {
"name": {
"type": "string",
"description": "Resource Domain Name",
"pattern": "^[A-Za-z0-9_]+$",
"maxLength": 32
},
"profileName": {
"type": "string",
"description": "Profile"
},
"sgNames": {
"type": "array",
"description": "Server Groups in Domain",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
Example
{
"name": "the_lab",
"profileName": "NONE",
"sgNames": [
"NO_SG",
"SO_SG1",
"SO1MP_SG1"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/resourcedomains/profiles
get /topo/resourcedomains/profiles
Returns the available Resource Domain Profiles.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/optionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/option/option.json",
"type" :"string"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
"Profile 1"
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/resourcedomains/{name}
get /topo/resourcedomains/{name}
Returns the configuration details for the specified Resource Domain.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/resourcedomainItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/resourcedomain/resourcedomain.json",
"type": "object",
"required": ["name","sgNames"],
"properties": {
"name": {
"type": "string",
"description": "Resource Domain Name",
"pattern": "^[A-Za-z0-9_]+$",
"maxLength": 32
},
"profileName": {
"type": "string",
"description": "Profile"
},
"sgNames": {
"type": "array",
"description": "Server Groups in Domain",
"items": {
"type": "string"
},
"minItems": 0
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "the_lab",
"profileName": "NONE",
"sgNames": [
"NO_SG",
"SO_SG1",
"SO1MP_SG1"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/resourcedomains/{name}
Updates the specified Resource Domain.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/resourcedomain/resourcedomain.json",
"type": "object",
"required": ["name","sgNames"],
"properties": {
"name": {
"type": "string",
"description": "Resource Domain Name",
"pattern": "^[A-Za-z0-9_]+$",
"maxLength": 32
},
"profileName": {
"type": "string",
"description": "Profile"
},
"sgNames": {
"type": "array",
"description": "Server Groups in Domain",
"items": {
"type": "string"
},
"minItems": 0
}
}
}
Example
{
"name": "the_lab",
"profileName": "NONE",
"sgNames": [
"NO_SG",
"SO_SG1",
"SO1MP_SG1"
]
}
delete /topo/resourcedomains/{name}
Deletes the specified Resource Domain.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Topo: Servers
A part of the topology API, the Servers resource provides access to Server configuration and management of the following server aspects:
- appl - Application - enable/disable the application
- ha - High Availability - control and manage high availability settings
- db - Database - control and manage databases
- repl - Replication - control and manage database replication
Performing status requests at the NOAM level will provide status of all servers in the topology. Performing status requests at the SOAM level will only provide status of Servers at that site.
Servers are uniquely identified using the hostname field.
Configuration of Servers is only available at the NOAM.
/topo/servers
get /topo/servers
Retrieves the configuration data for all Servers that meet the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/serverCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/server.json",
"type" : "object",
"required": ["hostname","networkElementName","profileName","location","role","ntpServers"],
"properties" : {
"hostname": {
"type": "string",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"description": "Server host name (not updatable)"
},
"networkElementName": {
"type": "string",
"description": "Network Element Name (not updatable)"
},
"serverGroupName": {
"type": "string",
"description": "The name of the Server Group (/topo/servergroups) to which this Server belongs. If there is no value returned by the DSR, this Server has not been associated with any Server Group. A Server can be associated with/removed from a Server Group using the /topo/servergroups/{name}/members URI.",
"readOnly": true
},
"profileName": {
"type": "string",
"description": "Hardware Profile (not updatable)"
},
"location": {
"type": "string",
"maxLength": 15,
"description": "Server Location"
},
"role": {
"type": "string",
"description": "Server Role (not updatable)",
"enum": [
"Mp",
"Noam",
"QueryServer",
"Soam"
]
},
"systemId": {
"type": "string",
"maxLength": 64,
"description": "System Identifier"
},
"ntpServers": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/ntppref/ntppref.json",
"type": "object",
"required": ["ipAddress"],
"properties": {
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"prefer": { "type": "boolean" }
}
},
"minItems": 0
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"hostname": "onett-noa",
"networkElementName": "NO_NE",
"serverGroupName": "NO_SG",
"profileName": "TVOE Guest",
"location": "Eagleland",
"role": "Noam",
"systemId": "CRABSYS",
"ntpServers": [
{
"ipAddress": "172.23.0.1",
"prefer": true
}
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/servers
Adds a new Server to the topology. Once a server is added to the configuration, it must be bootstrapped (/servers/{id}/bootstrap PUT) to complete the configuration process. The hostname field is the Server identifier and is returned in the POST response.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/server.json",
"type" : "object",
"required": ["hostname","networkElementName","profileName","location","role","ntpServers"],
"properties" : {
"hostname": {
"type": "string",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"description": "Server host name (not updatable)"
},
"networkElementName": {
"type": "string",
"description": "Network Element Name (not updatable)"
},
"serverGroupName": {
"type": "string",
"description": "The name of the Server Group (/topo/servergroups) to which this Server belongs. If there is no value returned by the DSR, this Server has not been associated with any Server Group. A Server can be associated with/removed from a Server Group using the /topo/servergroups/{name}/members URI.",
"readOnly": true
},
"profileName": {
"type": "string",
"description": "Hardware Profile (not updatable)"
},
"location": {
"type": "string",
"maxLength": 15,
"description": "Server Location"
},
"role": {
"type": "string",
"description": "Server Role (not updatable)",
"enum": [
"Mp",
"Noam",
"QueryServer",
"Soam"
]
},
"systemId": {
"type": "string",
"maxLength": 64,
"description": "System Identifier"
},
"ntpServers": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/ntppref/ntppref.json",
"type": "object",
"required": ["ipAddress"],
"properties": {
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"prefer": { "type": "boolean" }
}
},
"minItems": 0
}
}
}
Example
{
"hostname": "onett-noa",
"networkElementName": "NO_NE",
"serverGroupName": "NO_SG",
"profileName": "TVOE Guest",
"location": "Eagleland",
"role": "Noam",
"systemId": "CRABSYS",
"ntpServers": [
{
"ipAddress": "172.23.0.1",
"prefer": true
}
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/servers/profiles
get /topo/servers/profiles
Returns the available Server Hardware Profiles.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/optionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/option/option.json",
"type" :"string"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
"Profile 1"
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/servers/status
get /topo/servers/status
Retrieves Server status data for all Servers that match the request parameters.
Target server: NOAM
Secured by x-other
Request
Query Parameters
- scope_type: (one of Server, ServerGroup, NetworkElement)
Identifies the type of Server collection the results are limited to.
Example:
?scope_type=Server&scope_name=mynoa
- scope_name: (string)
Names the specific Server collection the results are limited to.
Example:
?scope_type=ServerGroup&scope_name=NO_SG
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/serverstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverstatus.json",
"type" : "object",
"required": ["hostname","networkElementName","applicationState","minor","major","critical","dbStatus","maxAllowedHaRole","haRole"],
"properties" : {
"hostname": {
"type": "string",
"description": "Server host name" ,
"example": "ruby-noa"
},
"networkElementName": {
"type": "string",
"description": "The Network Element (/topo/networkelements) of which this Server is a part.",
"example": "NO_NE"
},
"applicationState": {
"type": "string",
"enum": [
"Disabled",
"Enabled"
],
"description": "The administrative state of whatever application is running on the Server.",
"example": "Enabled"
},
"alarmStatus": {
"type": "string",
"enum": [
"Critical",
"Major",
"Minor",
"None",
"Clear"
],
"description": "Indicates the highest severity alarm currently sourced by the Server. When set to None, the Server is not currently sourcing any alarms.",
"example": "Minor"
},
"critical": {
"type": "integer",
"description": "Number of critical alarms on server",
"example": 0
},
"major": {
"type": "integer",
"description": "Number of major alarms on server",
"example": 1
},
"minor": {
"type": "integer",
"description": "Number of minor alarms on server",
"example": 5
},
"dbStatus": {
"type": "string",
"enum": [
"Normal",
"Clear",
"Minor",
"Major",
"Critical",
"BackupInProgress",
"RestoreInProgress",
"CompareInProgress",
"Unknown"
],
"description": "Indicates the overall status of the Server's database. When set to Normal, the database is not undergoing any maintenance actions and is free of any database-specific alarms. When set to Clear, the database-specific alarms are in the cleared state and the database is transitioning to the Normal state. The states of Minor, Major or Critical indicate that the database has one or more active database-specific alarms and the highest severity alarm is being reported. When set to Critical, the database version is incompatible with the installed software database version. When set to Major, one or more of the following is true: one or more process interfaces to the database are impaired by a software fault; a disk or shared memory configured database threshold has been exceeded; or the database durability has dropped below configured durability level. When set to Minor, one or more of the following is true: provisioning or replication has been disabled; a failure has occurred writing the database to the disk; the database update log has been overrun (which increases the chance for data loss); Database Replication process cannot apply updates to the database; or a database change cannot be stored in the update log. When set to BackupInProgress, a maintenance action of a database backup is in progress. When set to RestoreInProgress, a maintenance action of a database restore is in progress. When set to CompareInProgress, a maintenance action of a database compare is in progress. When set to Unknown, the database status of the server cannot be determined.",
"example": "Normal"
},
"maxAllowedHaRole": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby",
"NotApplicable",
"Unknown"
],
"description": "The maximum allowed High Availability (HA) role for the Server. The Server cannot attain an HA role higher than this value.",
"example": "Active"
},
"haRole": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby",
"Unknown"
],
"description": "The current HA role for the Server.",
"example": "Active"
},
"processStatus": {
"type": "string",
"enum": [
"Up",
"Kill",
"Pending",
"ApplicationSoftwareDisabled",
"Unknown"
],
"description": "Process Status Summary",
"example": "Indicates the overall status of all the processes on the server. When set to Up, all processes are up and running. When set to Kill, one or more processes have been stopped. Check the active alarms (/mon/alarms) to determine which process(es) are down. When set to Pending, one or more processes are in the pending state, which means they are in the process of coming up. When set to ApplicationSoftwareDisabled, the application software has been completely disabled. When set to Unknown, the process status of the server cannot be determined. If there are processes in multiple states, the value of processStatus will be is determined by the following order of precedence: Unknown, ApplicationSoftwareDisabled, Pending, Kill, Up."
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"hostname":"ruby-noa",
"networkElementName":"SO_NE1",
"applicationState":"Enabled",
"alarmStatus":"None",
"minor":0,
"major":0,
"critical":0,
"dbStatus":"Normal",
"maxAllowedHaRole":"Active",
"haRole":"Standby",
"processStatus":"Up"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/servers/{hostname}
get /topo/servers/{hostname}
Returns the configuration details for the specified Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/serverItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/server.json",
"type" : "object",
"required": ["hostname","networkElementName","profileName","location","role","ntpServers"],
"properties" : {
"hostname": {
"type": "string",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"description": "Server host name (not updatable)"
},
"networkElementName": {
"type": "string",
"description": "Network Element Name (not updatable)"
},
"serverGroupName": {
"type": "string",
"description": "The name of the Server Group (/topo/servergroups) to which this Server belongs. If there is no value returned by the DSR, this Server has not been associated with any Server Group. A Server can be associated with/removed from a Server Group using the /topo/servergroups/{name}/members URI.",
"readOnly": true
},
"profileName": {
"type": "string",
"description": "Hardware Profile (not updatable)"
},
"location": {
"type": "string",
"maxLength": 15,
"description": "Server Location"
},
"role": {
"type": "string",
"description": "Server Role (not updatable)",
"enum": [
"Mp",
"Noam",
"QueryServer",
"Soam"
]
},
"systemId": {
"type": "string",
"maxLength": 64,
"description": "System Identifier"
},
"ntpServers": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/ntppref/ntppref.json",
"type": "object",
"required": ["ipAddress"],
"properties": {
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"prefer": { "type": "boolean" }
}
},
"minItems": 0
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"hostname": "onett-noa",
"networkElementName": "NO_NE",
"serverGroupName": "NO_SG",
"profileName": "TVOE Guest",
"location": "Eagleland",
"role": "Noam",
"systemId": "CRABSYS",
"ntpServers": [
{
"ipAddress": "172.23.0.1",
"prefer": true
}
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/servers/{hostname}
Updates the configuration data for the specified Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/server.json",
"type" : "object",
"required": ["hostname","networkElementName","profileName","location","role","ntpServers"],
"properties" : {
"hostname": {
"type": "string",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"description": "Server host name (not updatable)"
},
"networkElementName": {
"type": "string",
"description": "Network Element Name (not updatable)"
},
"serverGroupName": {
"type": "string",
"description": "The name of the Server Group (/topo/servergroups) to which this Server belongs. If there is no value returned by the DSR, this Server has not been associated with any Server Group. A Server can be associated with/removed from a Server Group using the /topo/servergroups/{name}/members URI.",
"readOnly": true
},
"profileName": {
"type": "string",
"description": "Hardware Profile (not updatable)"
},
"location": {
"type": "string",
"maxLength": 15,
"description": "Server Location"
},
"role": {
"type": "string",
"description": "Server Role (not updatable)",
"enum": [
"Mp",
"Noam",
"QueryServer",
"Soam"
]
},
"systemId": {
"type": "string",
"maxLength": 64,
"description": "System Identifier"
},
"ntpServers": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/ntppref/ntppref.json",
"type": "object",
"required": ["ipAddress"],
"properties": {
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
},
"prefer": { "type": "boolean" }
}
},
"minItems": 0
}
}
}
Example
{
"hostname": "onett-noa",
"networkElementName": "NO_NE",
"serverGroupName": "NO_SG",
"profileName": "TVOE Guest",
"location": "Eagleland",
"role": "Noam",
"systemId": "CRABSYS",
"ntpServers": [
{
"ipAddress": "172.23.0.1",
"prefer": true
}
]
}
delete /topo/servers/{hostname}
Delete the server
Secured by x-other
Request
URI Parameters
- hostname: required (string)
/topo/servers/{hostname}/status
get /topo/servers/{hostname}/status
Retrieve the general status overview for a specific Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/serverstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverstatus.json",
"type" : "object",
"required": ["hostname","networkElementName","applicationState","minor","major","critical","dbStatus","maxAllowedHaRole","haRole"],
"properties" : {
"hostname": {
"type": "string",
"description": "Server host name" ,
"example": "ruby-noa"
},
"networkElementName": {
"type": "string",
"description": "The Network Element (/topo/networkelements) of which this Server is a part.",
"example": "NO_NE"
},
"applicationState": {
"type": "string",
"enum": [
"Disabled",
"Enabled"
],
"description": "The administrative state of whatever application is running on the Server.",
"example": "Enabled"
},
"alarmStatus": {
"type": "string",
"enum": [
"Critical",
"Major",
"Minor",
"None",
"Clear"
],
"description": "Indicates the highest severity alarm currently sourced by the Server. When set to None, the Server is not currently sourcing any alarms.",
"example": "Minor"
},
"critical": {
"type": "integer",
"description": "Number of critical alarms on server",
"example": 0
},
"major": {
"type": "integer",
"description": "Number of major alarms on server",
"example": 1
},
"minor": {
"type": "integer",
"description": "Number of minor alarms on server",
"example": 5
},
"dbStatus": {
"type": "string",
"enum": [
"Normal",
"Clear",
"Minor",
"Major",
"Critical",
"BackupInProgress",
"RestoreInProgress",
"CompareInProgress",
"Unknown"
],
"description": "Indicates the overall status of the Server's database. When set to Normal, the database is not undergoing any maintenance actions and is free of any database-specific alarms. When set to Clear, the database-specific alarms are in the cleared state and the database is transitioning to the Normal state. The states of Minor, Major or Critical indicate that the database has one or more active database-specific alarms and the highest severity alarm is being reported. When set to Critical, the database version is incompatible with the installed software database version. When set to Major, one or more of the following is true: one or more process interfaces to the database are impaired by a software fault; a disk or shared memory configured database threshold has been exceeded; or the database durability has dropped below configured durability level. When set to Minor, one or more of the following is true: provisioning or replication has been disabled; a failure has occurred writing the database to the disk; the database update log has been overrun (which increases the chance for data loss); Database Replication process cannot apply updates to the database; or a database change cannot be stored in the update log. When set to BackupInProgress, a maintenance action of a database backup is in progress. When set to RestoreInProgress, a maintenance action of a database restore is in progress. When set to CompareInProgress, a maintenance action of a database compare is in progress. When set to Unknown, the database status of the server cannot be determined.",
"example": "Normal"
},
"maxAllowedHaRole": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby",
"NotApplicable",
"Unknown"
],
"description": "The maximum allowed High Availability (HA) role for the Server. The Server cannot attain an HA role higher than this value.",
"example": "Active"
},
"haRole": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby",
"Unknown"
],
"description": "The current HA role for the Server.",
"example": "Active"
},
"processStatus": {
"type": "string",
"enum": [
"Up",
"Kill",
"Pending",
"ApplicationSoftwareDisabled",
"Unknown"
],
"description": "Process Status Summary",
"example": "Indicates the overall status of all the processes on the server. When set to Up, all processes are up and running. When set to Kill, one or more processes have been stopped. Check the active alarms (/mon/alarms) to determine which process(es) are down. When set to Pending, one or more processes are in the pending state, which means they are in the process of coming up. When set to ApplicationSoftwareDisabled, the application software has been completely disabled. When set to Unknown, the process status of the server cannot be determined. If there are processes in multiple states, the value of processStatus will be is determined by the following order of precedence: Unknown, ApplicationSoftwareDisabled, Pending, Kill, Up."
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"hostname":"ruby-noa",
"networkElementName":"SO_NE1",
"applicationState":"Enabled",
"alarmStatus":"None",
"minor":0,
"major":0,
"critical":0,
"dbStatus":"Normal",
"maxAllowedHaRole":"Active",
"haRole":"Standby",
"processStatus":"Up"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/topo/servers/{hostname}/appl
get /topo/servers/{hostname}/appl
Retrieves the application status for the specifeid Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/serverapplItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverappl.json",
"type": "object",
"required": ["applState"],
"properties": {
"applState": {
"type": "string",
"description": "Application State",
"enum": [ "Enabled", "Disabled" ],
"example": "Enabled"
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"applState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/servers/{hostname}/appl
Used to stop or (re)start the application services on a Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverappl.json",
"type": "object",
"required": ["applState"],
"properties": {
"applState": {
"type": "string",
"description": "Application State",
"enum": [ "Enabled", "Disabled" ],
"example": "Enabled"
}
}
}
Example
{
"applState": "Enabled"
}
/topo/servers/{hostname}/ha
get /topo/servers/{hostname}/ha
Retrieves the High Availability status and role for a Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverha.json",
"type" : "object",
"required": ["hostname","networkElementName","maxHaRole","oamMaxHaRole","appMaxHaRole","serverRole","maxHaCapability","mates"],
"properties" : {
"hostname": {
"type": "string",
"description": "Server host name (non updatable)" ,
"example": "monotoli-noa"
},
"networkElementName": {
"type": "string",
"description": "Network Element Name (non updatable)",
"example": "NO_NE"
},
"maxHaRole": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby"
],
"description": "Max HA Role (non updatable)",
"example": "Active"
},
"oamMaxHaRole": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby"
],
"description": "Max OAM HA Role (non updatable)",
"example": "Active"
},
"appMaxHaRole": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby"
],
"description": "Max Application HA Role (non updatable)",
"example": "Active"
},
"serverRole": {
"type": "string",
"enum": [
"Mp",
"Noam",
"QueryServer",
"Soam"
],
"description": "Server Role (non updatable)",
"example": "Noam"
},
"maxHaCapability": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby"
],
"description": "Max Allowed HA Role",
"example": "Active"
},
"mates": {
"type": "array",
"description": "List of mate hostnames (non updatable)",
"items": {
"description": "Mate hostname",
"type": "string"
},
"minItems": 0,
"example" : [ "monotoli-nob" ]
}
}
}
Example
{
"hostname": "monotoli-noa",
"networkElementName": "NO_NE",
"maxHaRole": "Active",
"oamMaxHaRole": "Active",
"appMaxHaRole": "Oos",
"serverRole": "Noam",
"maxHaCapability": "Active",
"mates": [
"monotoli-nob"
]
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/servers/{hostname}/ha
Updates the maximum High Availability role for a Server.
Updating the role of a Server may cause a resource to failover to another server in the cluster. Here are some possible settings:
- Active (default) - the Server is allowed to become active.
- Standby - the Server is allowed to become (at most) standby.
- Spare - the Server is allowed to become (at most) spare.
- Observer - the Server will be an observer (providing read only access).
- Oos - the Server is taken out of service.
Setting an active Server to have a max role of standby will force a failover. This is a required step in the software upgrade process.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/servermaxha.json",
"type" : "object",
"required": ["maxHaCapability"],
"properties" : {
"maxHaCapability": {
"type": "string",
"enum": [
"Active",
"Observer",
"Oos",
"Spare",
"Standby"
],
"description": "Max Allowed HA Role",
"example": "Active"
}
}
}
Example
{
"maxHaCapability": "Active"
}
/topo/servers/{hostname}/repl
get /topo/servers/{hostname}/repl
Retrieves the database replication status for a Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverrepl.json",
"type": "object",
"required": ["replState"],
"properties": {
"replState": {
"type": "string",
"description": "Replication State",
"enum": [ "Allowed", "Inhibited" ],
"example": "Allowed"
}
}
}
Example
{
"relStatus": "Allowed"
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/servers/{hostname}/repl
Manage database replication for a Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverrepl.json",
"type": "object",
"required": ["replState"],
"properties": {
"replState": {
"type": "string",
"description": "Replication State",
"enum": [ "Allowed", "Inhibited" ],
"example": "Allowed"
}
}
}
Example
{
"relStatus": "Allowed"
}
/topo/servers/{hostname}/db
get /topo/servers/{hostname}/db
Retrieves the active database status for the specified Server.
Returns various status items for the database on a specific server, including:
- durability status
- DB versions and creation data (birthday)
- DB capacities and utilization
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/serverdbItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverdb.json",
"type": "object",
"properties": {
"dbBirthday": {
"description": "Database birthday",
"type": "string",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"example": "2015-07-30T12:37:48-04:00"
},
"dbVersionAW": {
"description": "AppWorks database version",
"type": "string",
"example": "6.0"
},
"dbVersionAPP": {
"description": "Application database version",
"type": "string",
"example": "6.0.1_60.32.6"
},
"dbLevel": {
"description": "Database level",
"type": "integer",
"example": 0
},
"dbMemUse": {
"description": "Database memory usage",
"type": "object",
"properties": {
"used": {
"type": "string",
"example": "794M"
},
"total": {
"type": "string",
"example": "3076M"
},
"avail": {
"type": "string",
"example": "2282M"
}
}
},
"dbDiskUse": {
"description": "Database disk usage",
"type": "object",
"properties": {
"used": {
"type": "string",
"example": "213M"
},
"total": {
"type": "string",
"example": "4.8G"
},
"avail": {
"type": "string",
"example": "4.4G"
}
}
},
"dbDurability": {
"description": "Database durability",
"type": "object",
"properties": {
"statusTime": {
"type": "string",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"example": "2015-08-06T16:56:28-04:00"
},
"stateTime": {
"type": "string",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"example": "2015-07-30T12:43:40-04:00"
},
"runState": {
"type": "string",
"example": "Normal"
},
"adminState": {
"type": "string",
"example": "DiskOnly"
},
"operState": {
"type": "string",
"example": "DiskMate"
},
"memDbLevel": {
"type": "integer",
"example": 0
},
"diskDbLevel": {
"type": "integer",
"example": 0
},
"mateDbLevel": {
"type": "integer",
"example": 0
},
"secondaryDbLevel": {
"type": "integer",
"example": 0
},
"durableLevel": {
"type": "integer",
"example": 0
}
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"dbBirthday": "2015-07-30T12:37:48-04:00",
"dbVersionAW": "6.0",
"dbVersionAPP": "6.0.1_60.32.6",
"dbLevel": 0,
"dbMemUse": {
"used": "794M",
"total": "3076M",
"avail": "2282M"
},
"dbDiskUse": {
"used": "213M",
"total": "4.8G",
"avail": "4.4G"
},
"dbDurability": {
"statusTime": "2015-08-06T16:56:28-04:00",
"stateTime": "2015-07-30T12:43:40-04:00",
"runState": "Normal",
"adminState": "DiskOnly",
"operState": "DiskMate",
"memDbLevel": 0,
"diskDbLevel": 0,
"mateDbLevel": 0,
"secondaryDbLevel": 0,
"durableLevel": 0
}
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/topo/servers/{hostname}/db/backup
get /topo/servers/{hostname}/db/backup
Returns a list of all database backups for the specified Server.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/serverdbbackupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverdbbackup.json",
"type": "object",
"required": ["type", "filename", "comment"],
"nonInsertable": ["UUID", "status"],
"properties": {
"UUID": {
"type": "string",
"description": "The backup instance identifier (*generated*)",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"example": "0a3c24c2-873b-4412-b595-c2afe16f1ccc"
},
"compression": {
"type": "string",
"description": "Compression type",
"enum": [
"Bzip2",
"Gzip",
"None"
]
},
"type": {
"type": "string",
"description": "The backup type",
"enum": [ "Configuration", "Provisioning", "Both" ]
},
"filename": {
"type": "string",
"description": "The backup instance filename. On POST without the compression suffix.",
"example": "Backup.alexa.ruby-noa.Configuration.NETWORK_OAMP.20150801_021502.AUTO.tar",
"maxLength": 249
},
"comment": {
"type": "string",
"description": "A comment to associate with the backup instance"
},
"status": {
"type": "string",
"description": "The backup status",
"enum": [
"Complete",
"InProgress"
]
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"compression": "Bzip2",
"type": "Provisioning",
"filename": "Backup.alexa.ruby-noa.Provisioning.NETWORK_OAMP.20150801_021502.AUTO.tar",
"comment": "A sample comment"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/servers/{hostname}/db/backup
Initiates a database backup for a Server. Once initiated, the backup status can be tracked using the returned link to the GET /servers/{hostname}/db/backup/{UUID} resource. The generated UUID will be included in the response body.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverdbbackup.json",
"type": "object",
"required": ["type", "filename", "comment"],
"nonInsertable": ["UUID", "status"],
"properties": {
"UUID": {
"type": "string",
"description": "The backup instance identifier (*generated*)",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"example": "0a3c24c2-873b-4412-b595-c2afe16f1ccc"
},
"compression": {
"type": "string",
"description": "Compression type",
"enum": [
"Bzip2",
"Gzip",
"None"
]
},
"type": {
"type": "string",
"description": "The backup type",
"enum": [ "Configuration", "Provisioning", "Both" ]
},
"filename": {
"type": "string",
"description": "The backup instance filename. On POST without the compression suffix.",
"example": "Backup.alexa.ruby-noa.Configuration.NETWORK_OAMP.20150801_021502.AUTO.tar",
"maxLength": 249
},
"comment": {
"type": "string",
"description": "A comment to associate with the backup instance"
},
"status": {
"type": "string",
"description": "The backup status",
"enum": [
"Complete",
"InProgress"
]
}
}
}
Example
{
"compression": "Bzip2",
"type": "Provisioning",
"filename": "Backup.alexa.ruby-noa.Provisioning.NETWORK_OAMP.20150801_021502.AUTO.tar",
"comment": "A sample comment"
}
/topo/servers/{hostname}/db/backup/{UUID}
get /topo/servers/{hostname}/db/backup/{UUID}
Returns a specific backup for a specific Server.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
- UUID: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/serverdbbackupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverdbbackup.json",
"type": "object",
"required": ["type", "filename", "comment"],
"nonInsertable": ["UUID", "status"],
"properties": {
"UUID": {
"type": "string",
"description": "The backup instance identifier (*generated*)",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"example": "0a3c24c2-873b-4412-b595-c2afe16f1ccc"
},
"compression": {
"type": "string",
"description": "Compression type",
"enum": [
"Bzip2",
"Gzip",
"None"
]
},
"type": {
"type": "string",
"description": "The backup type",
"enum": [ "Configuration", "Provisioning", "Both" ]
},
"filename": {
"type": "string",
"description": "The backup instance filename. On POST without the compression suffix.",
"example": "Backup.alexa.ruby-noa.Configuration.NETWORK_OAMP.20150801_021502.AUTO.tar",
"maxLength": 249
},
"comment": {
"type": "string",
"description": "A comment to associate with the backup instance"
},
"status": {
"type": "string",
"description": "The backup status",
"enum": [
"Complete",
"InProgress"
]
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"compression": "Bzip2",
"type": "Provisioning",
"filename": "Backup.alexa.ruby-noa.Provisioning.NETWORK_OAMP.20150801_021502.AUTO.tar",
"comment": "A sample comment"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/servers/{hostname}/db/backup/{UUID}/compare
get /topo/servers/{hostname}/db/backup/{UUID}/compare
Returns a comparison report for a database on a specific Server. The report must have been previously generated using the /topo/servers/{hostname}/db/backup/{UUID}/compare POST operation.
Target server: NOAM or SOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
- UUID: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/serverdbcompareItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverdbcompare.json",
"type": "object",
"required": ["report"],
"properties": {
"report": {
"type": "string",
"description": "Database backup archive comparison report."
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"report": "Alexa Compatibility\nCompatible\n\nThe selected database came from stock72-noa on 06/25/2016 at 02:15:15 EDT and contains the following comment: Nightly Automatic Backup of Configuration Data\n\n\nArchive Contents\nConfiguration data\n\nDatabase Compatibility\nThe databases are compatible.\n\nNode Type Compatibility\nThe node types are compatible.\n\nTopology Compatibility\nThe topology is compatible.\n\nUser Compatibility\nThe user and authentication data are compatible.\n\nContents\nConfiguration\n\nTable Instance Counts\nCurrent ADICCmd count: 2 Selected: 2\nCurrent APIKeys count: 2 Selected: 2\nCurrent APITokens count: 2 Selected: 2\nCurrent AWCerts count: 2 Selected: 2\nCurrent AppworksCapacityConstraints count: 2 Selected: 2\nCurrent AuthKeys count: 18 Selected: 18\nCurrent AuthorizedIp count: 2 Selected: 2\nCurrent AwpSampleDemo count: 3 Selected: 3\nCurrent ClusterGroupInfo count: 3 Selected: 3\nCurrent ClusterInfo count: 3 Selected: 3\nCurrent Crontab count: 2 Selected: 2\nCurrent DbReInitList count: 2 Selected: 2\nCurrent DefaultNtpReference count: 2 Selected: 2\nCurrent DnsConfiguration count: 2 Selected: 2\nCurrent DoubleParam count: 2 Selected: 2\nCurrent DscpByIntf count: 2 Selected: 2\nCurrent DscpByPort count: 2 Selected: 2\nCurrent FailedAccessLog count: 2 Selected: 2\nCurrent Function count: 2 Selected: 2\nCurrent FunctionAbilities count: 2 Selected: 2\nCurrent HaCfg count: 3 Selected: 3\nCurrent HaClusterPolicyCfg count: 2 Selected: 2\nCurrent HaClusterResourceCfg count: 2 Selected: 2\nCurrent HaDefParms count: 2 Selected: 2\nCurrent HaNodeCfg count: 2 Selected: 2\nCurrent HaNodeLocPref count: 6 Selected: 6\nCurrent HaNodePolicyCfg count: 2 Selected: 2\nCurrent HaNodeResourceCfg count: 2 Selected: 2\nCurrent HaParms count: 2 Selected: 2\nCurrent HaPolicyCfg count: 2 Selected: 2\nCurrent HaResourceCfg count: 3 Selected: 3\nCurrent HaSiteCfg count: 2 Selected: 2\nCurrent HaSiteLocPref count: 2 Selected: 2\nCurrent HaVipDef count: 2 Selected: 2\nCurrent KPIDef count: 110 Selected: 110\nCurrent KPIUserPref count: 7 Selected: 7\nCurrent L3Interface count: 12 Selected: 12\nCurrent LDAPServer count: 2 Selected: 2\nCurrent LogicalPath count: 12 Selected: 12\nCurrent LongParam count: 41 Selected: 41\nCurrent MasterLoginAttempts count: 2 Selected: 2\nCurrent NameServiceChangeList count: 2 Selected: 2\nCurrent Network count: 4 Selected: 4\nCurrent NetworkDevice count: 12 Selected: 12\nCurrent NetworkDeviceOption count: 48 Selected: 48\nCurrent NetworkElement count: 2 Selected: 2\nCurrent NetworkRoute count: 2 Selected: 2\nCurrent NetworkType count: 13 Selected: 13\nCurrent NodeInfo count: 6 Selected: 6\nCurrent NtpChangeList count: 2 Selected: 2\nCurrent NtpServer count: 6 Selected: 6\nCurrent NtpServer2SG count: 2 Selected: 2\nCurrent OGTApplStatus count: 2 Selected: 2\nCurrent PeriodicTask count: 2 Selected: 2\nCurrent Place count: 2 Selected: 2\nCurrent Place2Assoc count: 2 Selected: 2\nCurrent PlaceAssoc count: 2 Selected: 2\nCurrent PlaceAssocType count: 2 Selected: 2\nCurrent PlaceType count: 2 Selected: 2\nCurrent ProductEvID count: 4 Selected: 4\nCurrent RemoteServer count: 2 Selected: 2\nCurrent ResourceDomain count: 2 Selected: 2\nCurrent ResourceDomainProfile count: 3 Selected: 3\nCurrent SG2SuperGroup count: 3 Selected: 3\nCurrent SGNEAssociation count: 2 Selected: 2\nCurrent SNMPTrapIndex count: 2 Selected: 2\nCurrent SNMPacknowledgement count: 2 Selected: 2\nCurrent Server count: 6 Selected: 6\nCurrent Server2SG count: 6 Selected: 6\nCurrent ServerGroup count: 3 Selected: 3\nCurrent ServerGroup2RD count: 2 Selected: 2\nCurrent ServerProfile count: 6 Selected: 6\nCurrent ServiceCategory count: 7 Selected: 7\nCurrent ServiceMap count: 15 Selected: 15\nCurrent SftpUsers count: 2 Selected: 2\nCurrent Site count: 2 Selected: 2\nCurrent SiteInfo count: 3 Selected: 3\nCurrent SnmpCfg count: 2 Selected: 2\nCurrent SoapSecurityConfig count: 2 Selected: 2\nCurrent StringParam count: 13 Selected: 13\nCurrent SuperGroup count: 3 Selected: 3\nCurrent SwitchGroup count: 2 Selected: 2\nCurrent TaskMetaDefinition count: 18 Selected: 18\nCurrent TopologyMapping count: 6 Selected: 6\nCurrent UpgradeStatus count: 2 Selected: 2\nCurrent VirtualIp count: 2 Selected: 2\nCurrent VirtualL3Interface count: 2 Selected: 2\nCurrent VlobParam count: 2 Selected: 2\nCurrent alarmconfig count: 3 Selected: 3\nCurrent app_config_perms count: 2 Selected: 2\nCurrent custom_perms count: 2 Selected: 2\nCurrent groups count: 2 Selected: 2\nCurrent permissions count: 48 Selected: 48\nCurrent sampleCfg count: 3 Selected: 3\nCurrent timezones count: 2 Selected: 2\nCurrent user count: 2 Selected: 2\n"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/servers/{hostname}/db/backup/{UUID}/compare
Initiates a comparison of the active database versus the backup archive specified as a URL parameter on the server specified by a URL parameter.
Once initiated, the compare report can be obtained using the returned link to the /servers/{hostname}/db/backup/{UUID}/compare GET resource. The backup file's UUID will be returned.
Target server: NOAM or SOAM
Secured by x-other
/topo/servers/{hostname}/db/backup/{UUID}/restore
get /topo/servers/{hostname}/db/backup/{UUID}/restore
Retrieves the status of a restore operation for a particular Server.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
- UUID: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/serverdbrestoreItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverdbrestore.json",
"type": "object",
"required": ["expected_end_time", "maint_status", "cmd_status", "cmd_output"],
"properties": {
"expected_end_time": {
"description": "Expected end time for restore operation",
"type": "string",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"example": "2016-01-04T12:37:48-05:00"
},
"maint_status": {
"description": "Maintenance status",
"type": "string",
"example": "MAINT_CMD_SUCCESS"
},
"cmd_status": {
"description": "Command status",
"type": "integer",
"example": 0
},
"cmd_output": {
"description": "Command output",
"type": "string",
"example": "Success"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"expected_end_time": "2016-01-04T12:37:48-05:00",
"maint_status": "MAINT_CMD_FAILED",
"cmd_status": 1,
"cmd_output": "Failed to restore database archive"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/servers/{hostname}/db/backup/{UUID}/restore
Initiates a database restore for a specific Server.
Once initiated, the restore status can be tracked using the returned link to the /servers/{hostname}/db/backup/{UUID}/restore GET resource.
Note: access to the server may be temporarily impaired while a restore is in progress.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
- UUID: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverdbrestorereq.json",
"type": "object",
"required": ["force"],
"properties": {
"force": {
"description": "Whether to ignore compare errors when restoring a backup archive",
"type": "boolean"
}
}
}
Example
{
"force": false
}
/topo/servers/{hostname}/reboot
put /topo/servers/{hostname}/reboot
Reboots the specified Server.
Warning - this is service affecting!
Target server: NOAM
Secured by x-other
/topo/servers/{hostname}/ntpsync
put /topo/servers/{hostname}/ntpsync
Synchronizes NTP on the specified Server.
Target server: NOAM
Secured by x-other
/topo/servers/{hostname}/bootstrap
put /topo/servers/{hostname}/bootstrap
Bootstraps a Server. Bootstrap options are processed in order, and each option represents a switch that can be enabled/disabled.
These special options may be used turn everything on or off:
- none - Turn off all options
- all - Turn on all options
The following bootstrap options must be proceeded with "+" (enable) or "-" (disable):
- hostname - Configure using the provided hostname
- ntp - Configure the NTP protocol
- tz - Configure using the provided Time Zone
- network - Configure networking devices
- dns - Configure DNS
The following two option sets are equivalent:
- { "all":"", "-hostname":"", "-ntp":"", "-tz":"" }
- { "none":"", "+network":"", "+dns":"" }
There are two bootstrap option paths, then: either start with nothing and grow, or start with everything and shrink the bootstrap option set.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/server/serverbootstrap.json",
"type": "object",
"required": ["host","options"],
"properties": {
"host": {
"description": "IP address of the configuration server",
"type": "string",
"example":"192.168.1.100"
},
"options": {
"type": "object",
"additionalProperties": {
"type": "string",
"description": "bootstrap option values"
}
}
}
}
Example
{
"host": "192.168.1.100",
"options": {
"none": "",
"+hostname": "",
"+tz": "Americas/New_York",
"+ntp": "",
"+network": "",
"+dns": ""
}
}
Topo: Server Groups
Server Groups are used to place Servers into a fault tolerant association. Each item in the Server Group collection is identified using its name.
Configuration of Server Groups is only available at the NOAM.
/topo/servergroups
get /topo/servergroups
Returns the details for all configured Server Groups.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/servergroupCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/servergroup.json",
"type": "object",
"required": ["name", "level", "parentSgName", "functionName"],
"properties": {
"name": {
"type": "string",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"description": "Server Group Name"
},
"level": {
"type": "string",
"enum": ["A", "B", "C"],
"description": "Level (not updatable)"
},
"parentSgName": {
"type": "string",
"description": "Parent (not updatable unless C-level node)"
},
"functionName": {
"type": "string",
"description": "Function (not updatable)"
},
"numWanRepConn": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"description": "Connection Count"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "NO_SG",
"level": "A",
"parentSgName": "NONE",
"functionName": "NONE",
"numWanRepConn": 1
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/servergroups
Creates a Server Group with the specified attributes and associates it with a collection of Servers. The name field is the identifier and is returned.
Target server: NOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/servergroup.json",
"type": "object",
"required": ["name", "level", "parentSgName", "functionName"],
"properties": {
"name": {
"type": "string",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"description": "Server Group Name"
},
"level": {
"type": "string",
"enum": ["A", "B", "C"],
"description": "Level (not updatable)"
},
"parentSgName": {
"type": "string",
"description": "Parent (not updatable unless C-level node)"
},
"functionName": {
"type": "string",
"description": "Function (not updatable)"
},
"numWanRepConn": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"description": "Connection Count"
}
}
}
Example
{
"name": "NO_SG",
"level": "A",
"parentSgName": "NONE",
"functionName": "NONE",
"numWanRepConn": 1
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/servergroups/functions
get /topo/servergroups/functions
Returns the available Server Group functions.
Target server: NOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/optionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/option/option.json",
"type" :"string"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
"Profile 1"
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/topo/servergroups/{name}
get /topo/servergroups/{name}
Returns the details for the named Server Group.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/servergroupItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/servergroup.json",
"type": "object",
"required": ["name", "level", "parentSgName", "functionName"],
"properties": {
"name": {
"type": "string",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"description": "Server Group Name"
},
"level": {
"type": "string",
"enum": ["A", "B", "C"],
"description": "Level (not updatable)"
},
"parentSgName": {
"type": "string",
"description": "Parent (not updatable unless C-level node)"
},
"functionName": {
"type": "string",
"description": "Function (not updatable)"
},
"numWanRepConn": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"description": "Connection Count"
}
}
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "NO_SG",
"level": "A",
"parentSgName": "NONE",
"functionName": "NONE",
"numWanRepConn": 1
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /topo/servergroups/{name}
Updates the named Server Group.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/servergroup.json",
"type": "object",
"required": ["name", "level", "parentSgName", "functionName"],
"properties": {
"name": {
"type": "string",
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"maxLength": 32,
"description": "Server Group Name"
},
"level": {
"type": "string",
"enum": ["A", "B", "C"],
"description": "Level (not updatable)"
},
"parentSgName": {
"type": "string",
"description": "Parent (not updatable unless C-level node)"
},
"functionName": {
"type": "string",
"description": "Function (not updatable)"
},
"numWanRepConn": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"description": "Connection Count"
}
}
}
Example
{
"name": "NO_SG",
"level": "A",
"parentSgName": "NONE",
"functionName": "NONE",
"numWanRepConn": 1
}
delete /topo/servergroups/{name}
Deletes the named Server Group. A Server Group can only be deleted if it has no associated Servers.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/topo/servergroups/{name}/prov
get /topo/servergroups/{name}/prov
Retrieves the database provisioning status for a Network / Site.
Target server: NOAM or SOAM
Secured by x-other
put /topo/servergroups/{name}/prov
Manage the database provisioning for a Network / Site.
Target server: NOAM
Secured by x-other
/topo/servergroups/{name}/members
get /topo/servergroups/{name}/members
Returns the list of Servers (members) that comprise the specified Server Group.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/memberCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/member.json",
"properties": {
"haRolePreference": {
"description": "Indicates the client's preferred High-Availability role for this Server (/topo/servers). When set to Active, the Server keeps the Active role as long as the Server remains available. When set to Standby, the Server only becomes Active if there is no other Server in the Server Group having a preferred haRolePreference of Active. In other words, if a Server's haRolePreference value is Standby, and if that Server is promoted to Active (because no other preferred-Active Server in the Server Group is available), and then another preferred-Active Server becomes available, the preferred-Standby Server will revert to the Standby role. When set to Spare, the Server is only promoted to Active or Standby if no other Servers in the Server Group are available to play the Active and Standby Roles. As soon as another Server becomes available to be Active or Standby, the preferred-Spare Server will revert to the Spare role. When set to Default, or if the client does not specify a value for haRolePreference, the DSR effectively treats the Server as having value Default.",
"enum": [ "Default", "Active", "Spare", "Standby" ],
"type": "string"
},
"hostname": {
"description": "The name of the Server (/topo/servers).",
"type": "string"
},
"serverGroupName": {
"description": "The name of the Server Group in which hostname is a member.",
"type": "string"
}
},
"required": [ "serverGroupName", "hostname"],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"haRolePreference":"Spare",
"hostname":"NO1",
"serverGroupName": "NO_SG"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/servergroups/{name}/members
Adds a Server to the Server Group.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/member.json",
"properties": {
"haRolePreference": {
"description": "Indicates the client's preferred High-Availability role for this Server (/topo/servers). When set to Active, the Server keeps the Active role as long as the Server remains available. When set to Standby, the Server only becomes Active if there is no other Server in the Server Group having a preferred haRolePreference of Active. In other words, if a Server's haRolePreference value is Standby, and if that Server is promoted to Active (because no other preferred-Active Server in the Server Group is available), and then another preferred-Active Server becomes available, the preferred-Standby Server will revert to the Standby role. When set to Spare, the Server is only promoted to Active or Standby if no other Servers in the Server Group are available to play the Active and Standby Roles. As soon as another Server becomes available to be Active or Standby, the preferred-Spare Server will revert to the Spare role. When set to Default, or if the client does not specify a value for haRolePreference, the DSR effectively treats the Server as having value Default.",
"enum": [ "Default", "Active", "Spare", "Standby" ],
"type": "string"
},
"hostname": {
"description": "The name of the Server (/topo/servers).",
"type": "string"
},
"serverGroupName": {
"description": "The name of the Server Group in which hostname is a member.",
"type": "string"
}
},
"required": [ "serverGroupName", "hostname"],
"type": "object"
}
Example
{
"haRolePreference":"Spare",
"hostname":"NO1",
"serverGroupName": "NO_SG"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/topo/servergroups/{name}/members/{hostname}
put /topo/servergroups/{name}/members/{hostname}
PUT is used to change a Server's {hostname} preferred High-Availability role within the Server Group {name}.
Target Server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
- hostname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/member.json",
"properties": {
"haRolePreference": {
"description": "Indicates the client's preferred High-Availability role for this Server (/topo/servers). When set to Active, the Server keeps the Active role as long as the Server remains available. When set to Standby, the Server only becomes Active if there is no other Server in the Server Group having a preferred haRolePreference of Active. In other words, if a Server's haRolePreference value is Standby, and if that Server is promoted to Active (because no other preferred-Active Server in the Server Group is available), and then another preferred-Active Server becomes available, the preferred-Standby Server will revert to the Standby role. When set to Spare, the Server is only promoted to Active or Standby if no other Servers in the Server Group are available to play the Active and Standby Roles. As soon as another Server becomes available to be Active or Standby, the preferred-Spare Server will revert to the Spare role. When set to Default, or if the client does not specify a value for haRolePreference, the DSR effectively treats the Server as having value Default.",
"enum": [ "Default", "Active", "Spare", "Standby" ],
"type": "string"
},
"hostname": {
"description": "The name of the Server (/topo/servers).",
"type": "string"
},
"serverGroupName": {
"description": "The name of the Server Group in which hostname is a member.",
"type": "string"
}
},
"required": [ "serverGroupName", "hostname"],
"type": "object"
}
Example
{
"haRolePreference":"Spare",
"hostname":"NO1",
"serverGroupName": "NO_SG"
}
delete /topo/servergroups/{name}/members/{hostname}
Removes the specified Server {hostname} from the Server Group {name}.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
- hostname: required (string)
/topo/servergroups/{name}/vips
get /topo/servergroups/{name}/vips
Returns the details of the specified Server Group's VIPs.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/collections/vipCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/vip.json",
"type": "object",
"required": ["serverGroupName","ipAddress"],
"properties": {
"UUID": {
"type": "string",
"description": "VIP Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"serverGroupName": {
"type": "string",
"description": "The name of the Server Group associated with this VIP"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"UUID": "2760ea35-a33e-4dde-a28e-0c6aee4cd1cc",
"serverGroupName": "NO_SG",
"ipAddress": "23.55.0.6"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /topo/servergroups/{name}/vips
Adds a VIP to the Server Group.
Target server: NOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/servergroup/vip.json",
"type": "object",
"required": ["serverGroupName","ipAddress"],
"properties": {
"UUID": {
"type": "string",
"description": "VIP Identifier (*computed*)",
"example": "3907f4f5-130b-4f99-9c8f-8b5d32d6112",
"pattern": "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"serverGroupName": {
"type": "string",
"description": "The name of the Server Group associated with this VIP"
},
"ipAddress":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/IPv4orIPv6/IPv4orIPv6.json",
"type": "string",
"pattern": "^$|^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])[.]){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$|^(default)$",
"example": "192.168.1.1"
}
}
}
Example
{
"UUID": "2760ea35-a33e-4dde-a28e-0c6aee4cd1cc",
"serverGroupName": "NO_SG",
"ipAddress": "23.55.0.6"
}
/topo/servergroups/{name}/vips/{uuid}
delete /topo/servergroups/{name}/vips/{uuid}
Deletes a Server Group VIP.
Target server: NOAM
Request
URI Parameters
- name: required (string)
- uuid: required (string)
Topo: Versions
The version of the MMI interface on the target for a given product. The version API is also available from the unversioned and unauthenticated alias:
The unversioned interface to /topo/versions will always return its version data as a JSON object including only these fields:
- product: the product name
- version: the product API version
- supports: an array of older supported API versions
/topo/versions
get /topo/versions
Retrieves both the current API version and a list of compatible versions.
Target server: NOAM or SOAM
Secured by x-other
Secured by none
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/topo/items/versionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/topo/version/version.json",
"type": "object",
"properties" : {
"product": { "type": "string", "description": "The MMI product name" },
"version": { "type": "string", "description": "The MMI product version" },
"supports": {
"type": "array",
"description": "Older supported product versions",
"items": { "type": "string" },
"minItems": 0
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"product": "alexa",
"version": "v4.0",
"supports": [
"v3.0",
"v2.5",
"v2.1"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Vstp: Accounting Measurement Options
The Accounting Measurement Options are those configuration values that govern the overall Accounting Measurement functionality. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Accounting Measurement Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT isused to update one or more values within theset of options. A name for this single, non-deletable instance is neither required nor expected.
All Accounting Measurement Options configuration is done at the SOAM.
/vstp/accountingmeasurementoptions
get /vstp/accountingmeasurementoptions
Returns the set of current values for the Accounting Measurement Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/accountingmeasurementoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/accountingmeasurementoption/accountingmeasurementoption.json",
"properties": {
"accountingMeasFeature": {
"description": "Accounting Measurement Feature. This parameter defines whether system wide Accounting Measurement Feature is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcCdpaAccMeasOption": {
"description": "DPC with Sccp Called Party Accounting Measurement Option. This parameter defines whether DPC with SCCP Called Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcCgpaAccMeasOption": {
"description": "DPC with Sccp Calling Party Accounting Measurement Option. This parameter defines whether DPC with SCCP Calling Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcLinksetAccMeasOption": {
"description": "Linkset with DPC Accounting Measurement Option. This parameter defines whether Linkset with DPC Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcSiNiAccMeasOption": {
"description": "DPC with SI and NI Accounting Measurement Option. This parameter defines whether DPC with SI and NI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"gttOnInterConnectingNw": {
"description": "GTT on Inter Connecting Network Measurement Option. This parameter defines whether GTT on Inter Connecting Network Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"gttRulePerLinksetAccMeasOption": {
"description": "GTT rule per Linkset Accounting Measurement Option. This parameter defines whether GTT rule per Linkset Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"linksetSiAccMeasOption": {
"description": "Linkset with SI Accounting Measurement Option. This parameter defines whether Linkset with SI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcCdpaAccMeasOption": {
"description": "OPC with Sccp Called Party Accounting Measurement Option. This parameter defines whether OPC with SCCP Called Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcCgpaAccMeasOption": {
"description": "OPC with Sccp Calling Party Accounting Measurement Option. This parameter defines whether OPC with SCCP Calling Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcDpcAccMeasOption": {
"description": "OPC with DPC Accounting Measurement Option. This parameter defines whether OPC with DPC Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcDpcNiAccMeasOption": {
"description": "OPC with DPC and NI Accounting Measurement Option. This parameter defines whether OPC with DPC and NI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcLinksetAccMeasOption": {
"description": "Linkset with OPC Accounting Measurement Option. This parameter defines whether Linkset with OPC Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcSiNiAccMeasOption": {
"description": "OPC with SI and NI Accounting Measurement Option. This parameter defines whether OPC with SI and NI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"accountingMeasFeature" : "No",
"dpcCdpaAccMeasOption" : "No",
"dpcCgpaAccMeasOption" : "No",
"dpcLinksetAccMeasOption" : "No",
"dpcSiNiMeasOption" : "No",
"gttOnInterConnectingNw": "No",
"gttRulePerLinksetAccMeasOption": "No",
"linksetSiAccMeasOption" : "No",
"opcCdpaAccMeasOption" : "No",
"opcCgpaAccMeasOption" : "No",
"opcDpcAccMeasOption" : "No",
"opcDpcNiAccMeasOption" : "No",
"opcLinksetAccMeasOption" : "No",
"opcSiNiMeasOption" : "No"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/accountingmeasurementoptions
Update the Accounting Measurement Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/accountingmeasurementoption/accountingmeasurementoption.json",
"properties": {
"accountingMeasFeature": {
"description": "Accounting Measurement Feature. This parameter defines whether system wide Accounting Measurement Feature is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcCdpaAccMeasOption": {
"description": "DPC with Sccp Called Party Accounting Measurement Option. This parameter defines whether DPC with SCCP Called Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcCgpaAccMeasOption": {
"description": "DPC with Sccp Calling Party Accounting Measurement Option. This parameter defines whether DPC with SCCP Calling Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcLinksetAccMeasOption": {
"description": "Linkset with DPC Accounting Measurement Option. This parameter defines whether Linkset with DPC Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"dpcSiNiAccMeasOption": {
"description": "DPC with SI and NI Accounting Measurement Option. This parameter defines whether DPC with SI and NI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"gttOnInterConnectingNw": {
"description": "GTT on Inter Connecting Network Measurement Option. This parameter defines whether GTT on Inter Connecting Network Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"gttRulePerLinksetAccMeasOption": {
"description": "GTT rule per Linkset Accounting Measurement Option. This parameter defines whether GTT rule per Linkset Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"linksetSiAccMeasOption": {
"description": "Linkset with SI Accounting Measurement Option. This parameter defines whether Linkset with SI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcCdpaAccMeasOption": {
"description": "OPC with Sccp Called Party Accounting Measurement Option. This parameter defines whether OPC with SCCP Called Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcCgpaAccMeasOption": {
"description": "OPC with Sccp Calling Party Accounting Measurement Option. This parameter defines whether OPC with SCCP Calling Party Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcDpcAccMeasOption": {
"description": "OPC with DPC Accounting Measurement Option. This parameter defines whether OPC with DPC Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcDpcNiAccMeasOption": {
"description": "OPC with DPC and NI Accounting Measurement Option. This parameter defines whether OPC with DPC and NI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcLinksetAccMeasOption": {
"description": "Linkset with OPC Accounting Measurement Option. This parameter defines whether Linkset with OPC Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"opcSiNiAccMeasOption": {
"description": "OPC with SI and NI Accounting Measurement Option. This parameter defines whether OPC with SI and NI Accounting Measurement is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
}
},
"type": "object"
}
Example
{
"accountingMeasFeature" : "No",
"dpcCdpaAccMeasOption" : "No",
"dpcCgpaAccMeasOption" : "No",
"dpcLinksetAccMeasOption" : "No",
"dpcSiNiMeasOption" : "No",
"gttOnInterConnectingNw": "No",
"gttRulePerLinksetAccMeasOption": "No",
"linksetSiAccMeasOption" : "No",
"opcCdpaAccMeasOption" : "No",
"opcCgpaAccMeasOption" : "No",
"opcDpcAccMeasOption" : "No",
"opcDpcNiAccMeasOption" : "No",
"opcLinksetAccMeasOption" : "No",
"opcSiNiMeasOption" : "No"
}
Vstp: AINP Options
The AINP Options are those configuration values that govern the overall AINP functionality . There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GETaction. No new AINP Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A namefor this single, non-deletable instance is neither required nor expected.
All AINP Options configuration is done at the SOAM.
/vstp/ainpoptions
get /vstp/ainpoptions
Returns the set of current values for the AINP Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/ainpoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/ainpoption/ainpoption.json",
"properties": {
"ainpdefrn": {
"description": "Default routing number. This parameter specifies a default routing number that is used for own-network subscribers.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"ainpsnai1-dialnai1": {
"description": "Combination of Service Nature of Address Indicator and Digits dialed nature of address indicator.The values for ainpsnai and dialnai must be separated by a hyphen (-). Allowable values for ainpsnai1 are [sub,natl,intl,unknown,none] and for dialnai the range is 0 to 1. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}([0-1])$)|^(None)$",
"type": "string"
},
"ainpsnai2-dialnai2": {
"description": "Combination of Service Nature of Address Indicator and Digits dialed nature of address indicator.The values for ainpsnai and dialnai must be separated by a hyphen (-). Allowable values for ainpsnai1 are [sub,natl,intl,unknown,none] and for dialnai the range is 0 to 1. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}([0-1])$)|^(None)$",
"type": "string"
},
"ainpccp": {
"description": "Copy charge parameters. When this parameter has a value of yes, the system copies the Charge Number and Charge Party Station type from an LNP AIN query (if present) to the LNP AIN Response message.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"ainplnpentpref": {
"description": "LNP entity preference is the first preference for the RTDB data / entity associated with a DN to be used as LRN.",
"enum" : [
"rn",
"grn",
"asd"
],
"default": "rn",
"type": "string"
},
"ainplnpnatldiglen": {
"description": "LNP national digit length.",
"maximum": 15,
"minimum": 1,
"default": 10,
"type": "integer"
},
"ainplnpogdnnai": {
"description": "LNP outgoing DN nature of address indicator. This parameter overrides the outgoing Nature of Number if DN is being returned.",
"enum" : [
"inc",
"sub",
"intl",
"natl",
"diglen"
],
"default": "inc",
"type": "string"
},
"ainplnpoglrnnai": {
"description": "LNP outgoing LRN nature of address indicator. This parameter overrides the outgoing Nature of Number if LRN is being returned.",
"enum" : [
"inc",
"sub",
"intl",
"natl",
"diglen"
],
"default": "inc",
"type": "string"
},
"ainplnpsnai": {
"description": "LNP service nature of address indicator. This parameter overrides the incoming Nature of Number in AIN Info_Analyzed CalledPartID.",
"enum" : [
"inc",
"sub",
"intl",
"natl",
"diglen"
],
"default": "inc",
"type": "string"
},
"ainplnpsubdiglen": {
"description": "LNP subscriber digit length.",
"maximum": 15,
"minimum": 1,
"default": 7,
"type": "integer"
},
"ainpnec": {
"description": "National Escape Code.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"ainprfmt": {
"description": "Routing address format. This parameter specifies the routing address format that is suported in the AINPQ Return Result response messages.",
"enum" : [
"asdrn",
"asdrndn",
"asdrnnecdn",
"asdrnccdn",
"ccasdrndn",
"ccgrndn",
"ccrngrndn",
"ccgrnrndn",
"ccrndn",
"ccrnasddn",
"homerndn",
"grn",
"grndn",
"grnrndn",
"grnrn",
"grnrnccdn",
"grnrnnecdn",
"rn",
"rnasd",
"rnasddn",
"rnasdccdn",
"rnasdnecdn",
"rndn",
"rngrn",
"rngrndn",
"rngrnccdn",
"rngrnnecdn",
"rnnecdn"
],
"default" : "rndn",
"type": "string"
},
"ainprnai": {
"description": "Routing Nature of Address Indicator.",
"enum" : [
"frmsg",
"intl",
"natl"
],
"default": "frmsg",
"type": "string"
},
"ainprnp": {
"description": "Routing numbering plan.",
"enum" : [
"e164",
"e212",
"priv",
"unknown"
],
"default": "e164",
"type": "string"
},
"ainpsprestype": {
"description": "SP response type. The type of message sent by the system if an NPREQ message is received, the DN digits match, and the HLR ID is present.",
"enum" : [
"rrwdgts",
"rrwodgts"
],
"default": "rrwodgts",
"type": "string"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ainpdefrn": "None",
"ainpsnai1-dialnai1": "None",
"ainpsnai2-dialnai2": "None",
"ainpccp": "No",
"ainplnpentpref": "rn",
"ainplnpnatldiglen": 10,
"ainplnpogdnnai": "inc",
"ainplnpoglrnnai": "inc",
"ainplnpsnai": "inc",
"ainplnpsubdiglen": 7,
"ainpnec": "None",
"ainprfmt": "rndn",
"ainprnai": "frmsg",
"ainprnp": "e164",
"ainpsprestype": "rrwodgts"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/ainpoptions
Update the AINP Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/ainpoption/ainpoption.json",
"properties": {
"ainpdefrn": {
"description": "Default routing number. This parameter specifies a default routing number that is used for own-network subscribers.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"ainpsnai1-dialnai1": {
"description": "Combination of Service Nature of Address Indicator and Digits dialed nature of address indicator.The values for ainpsnai and dialnai must be separated by a hyphen (-). Allowable values for ainpsnai1 are [sub,natl,intl,unknown,none] and for dialnai the range is 0 to 1. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}([0-1])$)|^(None)$",
"type": "string"
},
"ainpsnai2-dialnai2": {
"description": "Combination of Service Nature of Address Indicator and Digits dialed nature of address indicator.The values for ainpsnai and dialnai must be separated by a hyphen (-). Allowable values for ainpsnai1 are [sub,natl,intl,unknown,none] and for dialnai the range is 0 to 1. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}([0-1])$)|^(None)$",
"type": "string"
},
"ainpccp": {
"description": "Copy charge parameters. When this parameter has a value of yes, the system copies the Charge Number and Charge Party Station type from an LNP AIN query (if present) to the LNP AIN Response message.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"ainplnpentpref": {
"description": "LNP entity preference is the first preference for the RTDB data / entity associated with a DN to be used as LRN.",
"enum" : [
"rn",
"grn",
"asd"
],
"default": "rn",
"type": "string"
},
"ainplnpnatldiglen": {
"description": "LNP national digit length.",
"maximum": 15,
"minimum": 1,
"default": 10,
"type": "integer"
},
"ainplnpogdnnai": {
"description": "LNP outgoing DN nature of address indicator. This parameter overrides the outgoing Nature of Number if DN is being returned.",
"enum" : [
"inc",
"sub",
"intl",
"natl",
"diglen"
],
"default": "inc",
"type": "string"
},
"ainplnpoglrnnai": {
"description": "LNP outgoing LRN nature of address indicator. This parameter overrides the outgoing Nature of Number if LRN is being returned.",
"enum" : [
"inc",
"sub",
"intl",
"natl",
"diglen"
],
"default": "inc",
"type": "string"
},
"ainplnpsnai": {
"description": "LNP service nature of address indicator. This parameter overrides the incoming Nature of Number in AIN Info_Analyzed CalledPartID.",
"enum" : [
"inc",
"sub",
"intl",
"natl",
"diglen"
],
"default": "inc",
"type": "string"
},
"ainplnpsubdiglen": {
"description": "LNP subscriber digit length.",
"maximum": 15,
"minimum": 1,
"default": 7,
"type": "integer"
},
"ainpnec": {
"description": "National Escape Code.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"ainprfmt": {
"description": "Routing address format. This parameter specifies the routing address format that is suported in the AINPQ Return Result response messages.",
"enum" : [
"asdrn",
"asdrndn",
"asdrnnecdn",
"asdrnccdn",
"ccasdrndn",
"ccgrndn",
"ccrngrndn",
"ccgrnrndn",
"ccrndn",
"ccrnasddn",
"homerndn",
"grn",
"grndn",
"grnrndn",
"grnrn",
"grnrnccdn",
"grnrnnecdn",
"rn",
"rnasd",
"rnasddn",
"rnasdccdn",
"rnasdnecdn",
"rndn",
"rngrn",
"rngrndn",
"rngrnccdn",
"rngrnnecdn",
"rnnecdn"
],
"default" : "rndn",
"type": "string"
},
"ainprnai": {
"description": "Routing Nature of Address Indicator.",
"enum" : [
"frmsg",
"intl",
"natl"
],
"default": "frmsg",
"type": "string"
},
"ainprnp": {
"description": "Routing numbering plan.",
"enum" : [
"e164",
"e212",
"priv",
"unknown"
],
"default": "e164",
"type": "string"
},
"ainpsprestype": {
"description": "SP response type. The type of message sent by the system if an NPREQ message is received, the DN digits match, and the HLR ID is present.",
"enum" : [
"rrwdgts",
"rrwodgts"
],
"default": "rrwodgts",
"type": "string"
}
},
"required": [],
"type": "object"
}
Example
{
"ainpdefrn": "None",
"ainpsnai1-dialnai1": "None",
"ainpsnai2-dialnai2": "None",
"ainpccp": "No",
"ainplnpentpref": "rn",
"ainplnpnatldiglen": 10,
"ainplnpogdnnai": "inc",
"ainplnpoglrnnai": "inc",
"ainplnpsnai": "inc",
"ainplnpsubdiglen": 7,
"ainpnec": "None",
"ainprfmt": "rndn",
"ainprnai": "frmsg",
"ainprnp": "e164",
"ainpsprestype": "rrwodgts"
}
Vstp: Capacity
Capacity provides information about maximum allowed, currently configured, and free count of VSTP resources. This information is available system-wide and also for per STP-MP.
/vstp/capacity
get /vstp/capacity
Returns the capacity of VSTP resources in a valid GET request.
Target Server: SOAM
Secured by x-other
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/capacityCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/capacity/capacity.json",
"properties": {
"freeCapacity":{
"description": "Allowed number of entries that can be additionally configured for the resourceName",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"maximumCapacity":{
"description": "Maximum number of entries for the resourceName that can be configured in VSTP.",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"resourceName":{
"description": "Resource Name",
"maxLength": 255,
"pattern": "^[a-zA-Z][a-zA-Z]*$",
"type": "string"
},
"scope":{
"description": "Scope depicts whether the capacity is system-wide or per STP-MP",
"enum": [
"Server",
"Network Element"
],
"type": "string"
},
"scopeName":{
"description": "MP Server hostname. Scope name is only valid for Server and not for Network Element",
"type": "string",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30
},
"usedCapacity":{
"description": "Number of entries that are already configured for the resourceName.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"required": [
"resourceName",
"scope",
"usedCapacity"
],
"type": "object"
}
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
[
{
"freeCapacity": 269999,
"maximumCapacity": "270000",
"resourceName": "globaltitleaddresses",
"scope": "Network Element",
"usedCapacity": "1"
},
{
"resourceName": "links",
"scope": "Server",
"scopeName": "MP1",
"usedCapacity": "2"
}
]
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Vstp: CAT2 IMSIs
A CAT2 IMSI is an entity which are used to perform Category 2 securiry check for IMSI based. It will be used for IR21 upload feature.
All configuration of CAT2 IMSIs is done at the SOAM.
/vstp/cat2imsi
get /vstp/cat2imsi
Returns all CAT2 IMSIs that meet the criteria specified in the GET request. By default, all CAT2 IMSIs configured at the SOAM are returned. If paging parameters are supplied, only those CAT2 IMSIs meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=MtpScrSet1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/cat2imsiCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/cat2imsi/cat2imsi.json",
"properties": {
"tadigitCode": {
"description": "Name of TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"stadigitCode": {
"description": "Name of Sender TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"mccmnc": {
"description": "E212 mobile country code/mobile network code",
"maxLength": 6,
"pattern": "^([0-9]{5,6})$",
"type": "string"
},
"gtaLength": {
"description": "Represent the length of a gt for a particular STADIG Code",
"maximum": 15,
"minimum": 1,
"type": "integer"
}
},
"required": [
"mccmnc",
"tadigitCode",
"stadigitCode",
"gtaLength"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"tadigitCode": "INDT0",
"stadigitCode": "INDT0",
"mccmnc": "405025",
"gtaLength": 1
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/cat2imsi
Adds a new CAT2 IMSI to the VSTP configuration. The CAT2 IMSI name must be unique across all CAT2 IMSIs at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/cat2imsi/cat2imsi.json",
"properties": {
"tadigitCode": {
"description": "Name of TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"stadigitCode": {
"description": "Name of Sender TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"mccmnc": {
"description": "E212 mobile country code/mobile network code",
"maxLength": 6,
"pattern": "^([0-9]{5,6})$",
"type": "string"
},
"gtaLength": {
"description": "Represent the length of a gt for a particular STADIG Code",
"maximum": 15,
"minimum": 1,
"type": "integer"
}
},
"required": [
"mccmnc",
"tadigitCode",
"stadigitCode",
"gtaLength"
],
"type": "object"
}
Example
{
"tadigitCode": "INDT0",
"stadigitCode": "INDT0",
"mccmnc": "405025",
"gtaLength": 1
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
delete /vstp/cat2imsi
Deletes the specified CAT2 IMSI from the SOAM configuration. A CAT2 IMSI can only be deleted if all delete validation checks pass. An attempt to delete a CAT2 IMSI that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Vstp: CAT2 GTAs
A CAT2 GTA is an entity which are used to perform Category 2 securiry check for GTA based. It will be used for IR21 upload feature.
All configuration of CAT2 GTAs is done at the SOAM.
/vstp/cat2gta
get /vstp/cat2gta
Returns all CAT2 GTAs that meet the criteria specified in the GET request. By default, all network elements are configured at the SOAM are returned. If paging parameters are supplied, only those Network elements meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/cat2gtaCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/cat2gta/cat2gta.json",
"properties": {
"tadigitCode": {
"description": "Name of TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"stadigitCode": {
"description": "Name of Sender TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"gttStartAddress": {
"description": "Defines the start of a range of this Global Title Address.",
"maxLength": 15,
"pattern": "^([0-9]*)$",
"type": "string"
},
"gttEndAddress": {
"description": "End global title address. This parameter specifies the end of a range of global title digits.",
"maxLength": 15,
"pattern": "^([0-9]*)$",
"type": "string"
},
"nodeType": {
"description": "Type Of Node",
"enum": [
"HLR",
"MGT"
],
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this Network Element. The unique identifier value is a combination of gttStartAddress, gttEndAddress and nodeType. This identifier is created and assigned by vSTP.",
"readOnly": true,
"pattern": "^((([a-fA-F0-9]*)(-)){2}(HLR))|((([a-fA-F0-9]*)(-)){2}(MGT))$",
"type": "string"
}
},
"required": [
"nodeType",
"gttStartAddress",
"tadigitCode",
"stadigitCode"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"tadigitCode":"D123E",
"stadigitCode":"C123A",
"gttStartAddress":"1234567891",
"gttEndAddress":"2234567891",
"nodeType": "HLR"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/cat2gta
Adds a new CAT2 GTAs to the VSTP configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/cat2gta/cat2gta.json",
"properties": {
"tadigitCode": {
"description": "Name of TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"stadigitCode": {
"description": "Name of Sender TA Digit code. Valid names are strings between one and 5 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 5,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"gttStartAddress": {
"description": "Defines the start of a range of this Global Title Address.",
"maxLength": 15,
"pattern": "^([0-9]*)$",
"type": "string"
},
"gttEndAddress": {
"description": "End global title address. This parameter specifies the end of a range of global title digits.",
"maxLength": 15,
"pattern": "^([0-9]*)$",
"type": "string"
},
"nodeType": {
"description": "Type Of Node",
"enum": [
"HLR",
"MGT"
],
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this Network Element. The unique identifier value is a combination of gttStartAddress, gttEndAddress and nodeType. This identifier is created and assigned by vSTP.",
"readOnly": true,
"pattern": "^((([a-fA-F0-9]*)(-)){2}(HLR))|((([a-fA-F0-9]*)(-)){2}(MGT))$",
"type": "string"
}
},
"required": [
"nodeType",
"gttStartAddress",
"tadigitCode",
"stadigitCode"
],
"type": "object"
}
Example
{
"tadigitCode":"D123E",
"stadigitCode":"C123A",
"gttStartAddress":"1234567891",
"gttEndAddress":"2234567891",
"nodeType": "HLR"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
delete /vstp/cat2gta
Deletes the specified Network element from the SOAM configuration. A Sccp Loop can only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Vstp: Connection Configuration Sets
Connection Configuration Sets provide a way to tailor a VSTP Connection to account for the network quality of service and Remote Node (/vstp/remotenodes) requirements. A Connection Configuration Set is simply a collection of Connection (/vstp/connections) parameters that are grouped so the set can be easily assigned to multiple Connections.
The Connection Configuration Set named Default is always available. The Default Connection Configuration Set can be modified, but it cannot be deleted.
All attributes (except for the read-only configurationLevel) for Connection Configuration Sets are marked as required in the JSON schema. A client should GET the Default instance, copy it, modify any attributes, and POST the new instance. This way, all attributes have valid values.
All configuration of the Connection Configuration Set is done at the SOAM.
/vstp/connectionconfigurationsets
get /vstp/connectionconfigurationsets
Returns all Connection Configuration Sets that meet the criteria specified in the GET request. By default, all Connection Configuration Sets configured at the SOAM are returned. If paging parameters are supplied, only those Connection Configuration Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/connectionconfigurationsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with Connection configuration set which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Remote Node (/vstp/remotenodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Remote Node (/vstp/remotenodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the VSTP rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/vstp/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, VSTP fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the VSTP rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when a Connection (/vstp/connections) is started but the roundtrip time has not yet been measured. VSTP uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm VSTP uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the VSTP rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"name",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "52",
"connectionCfgSetName": "ConnectionConfigurationSet1",
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/connectionconfigurationsets
Adds a new Connection Configuration Set to the VSTP configuration. The Connection Configuration Set name must be unique across all Connection Configuration Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with Connection configuration set which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Remote Node (/vstp/remotenodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Remote Node (/vstp/remotenodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the VSTP rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/vstp/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, VSTP fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the VSTP rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when a Connection (/vstp/connections) is started but the roundtrip time has not yet been measured. VSTP uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm VSTP uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the VSTP rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"name",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize"
],
"type": "object"
}
Example
{
"configurationLevel": "52",
"connectionCfgSetName": "ConnectionConfigurationSet1",
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/connectionconfigurationsets/{name}
get /vstp/connectionconfigurationsets/{name}
Returns the configuration details for the specified Connection Configuration Set. If the Connection Configuration Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/connectionconfigurationsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with Connection configuration set which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Remote Node (/vstp/remotenodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Remote Node (/vstp/remotenodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the VSTP rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/vstp/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, VSTP fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the VSTP rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when a Connection (/vstp/connections) is started but the roundtrip time has not yet been measured. VSTP uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm VSTP uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the VSTP rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"name",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "52",
"connectionCfgSetName": "ConnectionConfigurationSet1",
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/connectionconfigurationsets/{name}
Updates the configuration of the specified Connection Configuration Set. If the provided Connection Configuration Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connectionconfigurationset/connectionconfigurationset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "Name associated with Connection configuration set which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sctpFragmentationEnabled": {
"description": "If true, a message exceeding the size of the path maximum transmission unit is fragmented and reassembled by the Remote Node (/vstp/remotenodes). Typical value is true.",
"type": "boolean"
},
"sctpHeartbeatInterval": {
"description": "The interval in milliseconds between sending SCTP heartbeat messages to a Remote Node (/vstp/remotenodes). Heartbeat messages are sent only when no user data has been sent for the duration of the sctpHeartbeatInterval. Setting sctpHeartbeatInterval to zero disables the heartbeat and is not recommended. When enabling the heartbeat, the minimum valid value is 100 ms - the VSTP rejects values between 1 and 99, inclusive. Typical value is 1000.",
"maximum": 300000,
"minimum": 0,
"type": "integer"
},
"sctpMaximumBurst": {
"description": "Specifies the maximum burst of packets that can be emitted by this Connection (/vstp/connections). Typical value is 4.",
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"sctpMaximumSegmentSize": {
"description": "The maximum size (in bytes) of any outgoing SCTP DATA chunk. If a message is larger than the sctpMaximumSegmentSize bytes, VSTP fragments the message into chunks not exceeding this size. Set the sctpMaximumSegmentSize to zero to not stipulate a maximum segment size. When specifying a maximum segment size, the minimum allowable value is 88 - the VSTP rejects values between 1 and 87, inclusive. Typical value is 0.",
"maximum": 1460,
"minimum": 0,
"type": "integer"
},
"sctpNumberInboundStreams": {
"description": "Maximum number of inbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpNumberOutboundStreams": {
"description": "Maximum number of outbound SCTP streams supported locally by the SCTP Connection (/vstp/connections). Typical value is 2.",
"maximum": 2,
"minimum": 1,
"type": "integer"
},
"sctpOrderedDelivery": {
"description": "If true, ordered delivery of the SCTP data chunk is performed; otherwise, delivery is unordered. Typical value is false.",
"type": "boolean"
},
"sctpRetransmissionAssociationFailure": {
"description": "Number of consecutive message retransmissions that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionAssociationFailure value indicates how many SCTP retransmission attempts should be made to all destinations for an SCTP Connection before marking the Connection as failed. This value should not be greater than the sum of the retransmission attempts for all destinations within the connection. Typical value is 5.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitFailure": {
"description": "Number of consecutive retransmits for INIT and COOKIE-ECHO chunks that cause an SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionInitFailure value indicates how many retransmission attempts should be made to the primary IP address for INIT and COOKIE-ECHO chunks (when a secondary IP address has not been configured) before marking the Connection as failed. If a secondary IP address has been configured, the retransmission attempts are alternated between the primary and secondary IP address. Typical value is 8.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"sctpRetransmissionInitTimeout": {
"description": "Expected average network roundtrip time in milliseconds. sctpRetransmissionInitTimeout is used to initialize the roundtrip time value when a Connection (/vstp/connections) is started but the roundtrip time has not yet been measured. VSTP uses the roundtrip time to calculate when to retransmit chunks of messages. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeout": {
"description": "Maximum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMaximumTimeout value places an upper boundary on the exponential back-off algorithm VSTP uses for SCTP retransmission timing. After the retransmit interval is reached, retransmits are sent at a constant rate until an acknowledgment is received or the maximum attempts is reached. Typical value is 120.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionMaximumTimeoutInit": {
"description": "Maximum time (in milliseconds) to wait for an INIT to be acknowledged. The sctpRetransmissionMaximumTimeoutInit value overrides the sctpRetransmissionMaximumTimeout and is used to bound the initial setup time. A value of zero indicates the sctpRetransmissionMaximumTimeout is used for INITs as well. When specifying an INIT timeout different from sctpRetransmissionMaximumTimeout, the minimum allowable value is 10 - the VSTP rejects values between 1 and 9, inclusive. Typical value is 120.",
"maximum": 10000,
"minimum": 0,
"type": "integer"
},
"sctpRetransmissionMinimumTimeout": {
"description": "Minimum time (in milliseconds) to wait for an acknowledgment of a message sent. The sctpRetransmissionMinimumTimeout value prevents the retransmit timeout from becoming too small in networks with a very short roundtrip time. Typical value is 120.",
"maximum": 5000,
"minimum": 10,
"type": "integer"
},
"sctpRetransmissionPathFailure": {
"description": "Number of consecutive unsuccessful message retransmisssions that causes a path of the SCTP Connection (/vstp/connections) to be marked as failed. The sctpRetransmissionPathFailure value indicates how many SCTP retransmission attempts should be made to each destination of an SCTP Connection before marking the destination as failed. This value must be less than the sctpRetransmissionAssociationFailure value. Typical value is 3.",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"sctpSackDelay": {
"description": "The number of milliseconds to delay after receiving a data chunk and before sending a SACK. A non-zero value for sctpSackDelay gives the application time to bundle data chunks in the same SCTP message with the SACK, thereby reducing the number of packets in the network. Setting sctpSackDelay to zero disables this delay so that SACKs are sent as quickly as possible. Typical value is 10.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"sctpSocketReceiveSize": {
"description": "Socket receive buffer size (in bytes) for incoming SCTP messages. The receive buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
},
"sctpSocketSendSize": {
"description": "Socket send buffer size (in bytes) for outgoing SCTP messages. The send buffer size must be greater than or equal to the product of the bandwidth and the roundtrip delay for the Connection (/vstp/connections). Typical value is 1000000.",
"maximum": 5000000,
"minimum": 8000,
"type": "integer"
}
},
"required": [
"name",
"sctpFragmentationEnabled",
"sctpHeartbeatInterval",
"sctpMaximumBurst",
"sctpMaximumSegmentSize",
"sctpNumberInboundStreams",
"sctpNumberOutboundStreams",
"sctpOrderedDelivery",
"sctpRetransmissionAssociationFailure",
"sctpRetransmissionInitFailure",
"sctpRetransmissionInitTimeout",
"sctpRetransmissionMaximumTimeout",
"sctpRetransmissionMaximumTimeoutInit",
"sctpRetransmissionMinimumTimeout",
"sctpRetransmissionPathFailure",
"sctpSackDelay",
"sctpSocketReceiveSize",
"sctpSocketSendSize"
],
"type": "object"
}
Example
{
"configurationLevel": "52",
"connectionCfgSetName": "ConnectionConfigurationSet1",
"sctpFragmentationEnabled": true,
"sctpHeartbeatInterval": 500,
"sctpMaximumBurst": 4,
"sctpMaximumSegmentSize": 0,
"sctpNumberInboundStreams": 8,
"sctpNumberOutboundStreams": 8,
"sctpOrderedDelivery": false,
"sctpRetransmissionAssociationFailure": 5,
"sctpRetransmissionInitFailure": 8,
"sctpRetransmissionInitTimeout": 120,
"sctpRetransmissionMaximumTimeout": 120,
"sctpRetransmissionMaximumTimeoutInit": 120,
"sctpRetransmissionMinimumTimeout": 120,
"sctpRetransmissionPathFailure": 3,
"sctpSackDelay": 10,
"sctpSocketReceiveSize": 1000000,
"sctpSocketSendSize": 1000000
}
delete /vstp/connectionconfigurationsets/{name}
Deletes the specified Connection Configuration Set from the SOAM configuration. The Default Connection Configuration Set cannot be deleted. A Connection Configuration Set can only be deleted if all delete validation checks pass. In general, if the Connection Configuration Set is a part of the configuration of one or more Connections (/vstp/connections), the Connection Configuration Set cannot be deleted. If the Connection Configuration Set is named in a Connection, the Connection Configuration Set must first be removed from the Connection. Then the Connection Configuration Set can be deleted from the configuration. An attempt to delete a Connection Configuration Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Connections
A Connection is the VSTP's logical representation of an M3UA association or an MTPA assocation, accessible over one or more transport Connections, with which the VSTP can transact VSTP messages. The Connection resource encapsulates all the characteristics of the Connection that the VSTP must know about in order to communicate successfully with it.
All Connection configuration is done at the SOAM.
/vstp/connections
get /vstp/connections
Returns all Connections that meet the criteria specified in the GET request. By default, all Connections configured at the SOAM are returned. If paging parameters are supplied, only those Connections meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/connectionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connection/connection.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/vstp/connectionconfigurationsets) assigned to this Connection. Default Connection Configuration Set name is 'Default'.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "This defines the mode of the Connection. When set to Client, the Connection is responsible to initiate SCTP association. When set to Server, the Connection expects the far end to initiate the Connection. The Default value for Connections (/vstp/connections) is Server.",
"enum": [
"Client",
"Server"
],
"type": "string"
},
"connectionType": {
"description": "This defines the type of the Connection. When set to M3ua, traffic is sent to the M3UA layer. When set to M2pa, traffic is sent to the M2PA layer.",
"enum": [
"M3ua",
"M2pa"
],
"type": "string"
},
"localHostName": {
"description": "Name for the Local Host (/vstp/localhosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the VSTP Connection, which must be unique within the DSR site. A name is required, and cannot be changed after the VSTP Connection is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostName": {
"description": "Name for the Remote Host (/vstp/remotehosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionType",
"localHostName",
"name",
"remoteHostName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "0",
"connCfgSetName": "Default",
"connectionMode": "Server",
"connectionType": "M3ua",
"localHostName": "LH4",
"name": "Conn7",
"remoteHostName": "RH7"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/connections
Adds a new Connection to the VSTP configuration. The new Connection must have a name that is unique across all Connections at the SOAM. In addition, the Connection's IP Port combination must also be unique across all Connections configured at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connection/connection.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/vstp/connectionconfigurationsets) assigned to this Connection. Default Connection Configuration Set name is 'Default'.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "This defines the mode of the Connection. When set to Client, the Connection is responsible to initiate SCTP association. When set to Server, the Connection expects the far end to initiate the Connection. The Default value for Connections (/vstp/connections) is Server.",
"enum": [
"Client",
"Server"
],
"type": "string"
},
"connectionType": {
"description": "This defines the type of the Connection. When set to M3ua, traffic is sent to the M3UA layer. When set to M2pa, traffic is sent to the M2PA layer.",
"enum": [
"M3ua",
"M2pa"
],
"type": "string"
},
"localHostName": {
"description": "Name for the Local Host (/vstp/localhosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the VSTP Connection, which must be unique within the DSR site. A name is required, and cannot be changed after the VSTP Connection is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostName": {
"description": "Name for the Remote Host (/vstp/remotehosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionType",
"localHostName",
"name",
"remoteHostName"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"connCfgSetName": "Default",
"connectionMode": "Server",
"connectionType": "M3ua",
"localHostName": "LH4",
"name": "Conn7",
"remoteHostName": "RH7"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/connections/status
get /vstp/connections/status
Returns the status of all Connections that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data (except operationalReason, statusKnown - these attributes cannot be filtered). Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, or IN. LIKE is not supported for these data types. Boolean attributes can be filtered using only EQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=Connection1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/connectionstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connection/connectionstatus.json",
"properties": {
"connAdminState": {
"description": "A Connection's administrative state can be either Enabled or Disabled. A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"localHostName": {
"description": "Name for the Local Host (/vstp/localhosts) associated with this Connection.",
"type": "string"
},
"mpServerHostname": {
"description": "Name of the VSTP-MP server that is currently reporting the status of this Connection.",
"type": "string"
},
"name": {
"description": "The configured name for the VSTP Connection.",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Connection.",
"type": "string"
},
"operationalStatus": {
"description": "The current operational state of the Connection. While this attribute can have a value of Down or Up, operationalReason attribute typically contains additional information elaborating on the reported operationalStatus.",
"enum": [
"Down",
"Up"
],
"type": "string"
},
"remoteHostName": {
"description": "Name for the Remote Host (/vstp/remotehosts) associated with this Connection.",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Connection are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this Connection, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Connection was last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"connAdminState": "Disabled",
"localHostName": "LH1",
"mpServerHostname": "amisha-soa1",
"name": "Connection1",
"operationalReason": "Disabled",
"operationalStatus": "Down",
"remoteHostName": "RH7",
"statusKnown": true,
"timeOfLastUpdate": "1969-12-31T19:00:00-05:00"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/vstp/connections/{name}
get /vstp/connections/{name}
Returns the configuration details for the specified Connection. If the specified Connection does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/connectionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connection/connection.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/vstp/connectionconfigurationsets) assigned to this Connection. Default Connection Configuration Set name is 'Default'.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "This defines the mode of the Connection. When set to Client, the Connection is responsible to initiate SCTP association. When set to Server, the Connection expects the far end to initiate the Connection. The Default value for Connections (/vstp/connections) is Server.",
"enum": [
"Client",
"Server"
],
"type": "string"
},
"connectionType": {
"description": "This defines the type of the Connection. When set to M3ua, traffic is sent to the M3UA layer. When set to M2pa, traffic is sent to the M2PA layer.",
"enum": [
"M3ua",
"M2pa"
],
"type": "string"
},
"localHostName": {
"description": "Name for the Local Host (/vstp/localhosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the VSTP Connection, which must be unique within the DSR site. A name is required, and cannot be changed after the VSTP Connection is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostName": {
"description": "Name for the Remote Host (/vstp/remotehosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionType",
"localHostName",
"name",
"remoteHostName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"connCfgSetName": "Default",
"connectionMode": "Server",
"connectionType": "M3ua",
"localHostName": "LH4",
"name": "Conn7",
"remoteHostName": "RH7"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/connections/{name}
Updates the configuration for the specified Connection. If the provided Connection data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/connection/connection.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connCfgSetName": {
"description": "The Connection Configuration Set (/vstp/connectionconfigurationsets) assigned to this Connection. Default Connection Configuration Set name is 'Default'.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"connectionMode": {
"description": "This defines the mode of the Connection. When set to Client, the Connection is responsible to initiate SCTP association. When set to Server, the Connection expects the far end to initiate the Connection. The Default value for Connections (/vstp/connections) is Server.",
"enum": [
"Client",
"Server"
],
"type": "string"
},
"connectionType": {
"description": "This defines the type of the Connection. When set to M3ua, traffic is sent to the M3UA layer. When set to M2pa, traffic is sent to the M2PA layer.",
"enum": [
"M3ua",
"M2pa"
],
"type": "string"
},
"localHostName": {
"description": "Name for the Local Host (/vstp/localhosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for the VSTP Connection, which must be unique within the DSR site. A name is required, and cannot be changed after the VSTP Connection is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostName": {
"description": "Name for the Remote Host (/vstp/remotehosts) associated with this Connection, must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"connectionType",
"localHostName",
"name",
"remoteHostName"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"connCfgSetName": "Default",
"connectionMode": "Server",
"connectionType": "M3ua",
"localHostName": "LH4",
"name": "Conn7",
"remoteHostName": "RH7"
}
delete /vstp/connections/{name}
Deletes the specified Connection from the SOAM configuration. A Connection is only deleted if all delete validation checks pass. In general, if the Connection is part of the configuration of some other resource instance, the Connection cannot be deleted. For example, if the Connection is named in a VSTP Link Set (/vstp/linksets), the Connection must first be removed from the Link Set. Then the Connection can be deleted from the configuration. An attempt to delete a Connection that cannot be deleted results in an error message returned within the HTTP response.
Any Connection that is administratively enabled cannot be deleted. The Connection must first be administratively disabled before deletion is allowed.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/vstp/connections/{name}/connectionadminstate
get /vstp/connections/{name}/connectionadminstate
Retrieves the administrative state, which can be either Enabled or Disabled, for the specified Connection.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/connectionadminstate.json",
"properties": {
"connectionAdminState": {
"description": "A Connection's administrative state can be either Enabled or Disabled. A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": ["connectionAdminState"],
"type": "object"
}
Example
{
"connectionAdminState": "Enabled"
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/connections/{name}/connectionadminstate
Updates the administrative state for the specified VSTP Connection to either Enable or Disabled.
A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/connectionadminstate.json",
"properties": {
"connectionAdminState": {
"description": "A Connection's administrative state can be either Enabled or Disabled. A Connection's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": ["connectionAdminState"],
"type": "object"
}
Example
{
"connectionAdminState": "Enabled"
}
Vstp: Common Screening Lists
A Common Screening List (CSL) is a collection of screening entries for the specified feature and screening list name, or a specific DS(digit string) for a particular feature and screening list name.
All configuration of Common Screening Lists is done at the SOAM.
/vstp/commonscreeninglists
get /vstp/commonscreeninglists
Returns all Common Screening Lists that meet the criteria specified in the GET request. By default, all Common Screening Lists configured at the SOAM are returned. If paging parameters are supplied, only those Common Screening List meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/commonscreeninglistCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/commonscreeninglist/commonscreeninglist.json",
"properties": {
"ds": {
"description": "Digit string. A unique string of digits that is used by the specified screening feature. Allowed length for different list is different. Ccnc : 1 to 6, Gta : 1 to 15, Skbcsm : 1 to 10, Sk : 4, Insl : 1 to 15.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"feature": {
"description": "Feature name. The name of the enabled feature for which the command is entered.",
"enum" : [
"idp_screening",
"idp_query_rely"
],
"type": "string"
},
"list": {
"description": "The name of the Common Screening List associated with the feature.",
"enum" : [
"Ccnc",
"Gta",
"Skbcsm",
"Sk",
"Insl",
"Imsipfx"
],
"default": "Imsipfx",
"type": "string"
},
"p1": {
"description": "Parameter Value 1. This parameter is specific to the feature and list that use the parameter. Allowed values are prepaid1 contibued to prepaid32 and prepaidno",
"maxLength": 10,
"pattern": "^([a-zA-Z0-9]*)$",
"default": "prepaidno",
"type": "string"
},
"p2": {
"description": "Parameter Value 2.Allowed values are idprcdpn, idprcdpn2, idprcdpn3, idprcdpn4 only.",
"maxLength": 10,
"pattern": "^([a-zA-Z0-9]*)$",
"default": "idprcdpn",
"type": "string"
},
"scpgta": {
"description": "Signaling Control Point (SCP) Global Title Address (GTA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this common screening list. The unique identifier value is a combination of feature, list and ds.",
"readOnly": true,
"pattern": "^((idp_screening|idp_service_key|idp_query_rely)(-)(Ccnc|Delpfx|Gta|Skbcsm|Sk|Insl|Vmpfx|Npflgrst|Trig|Npbypass|Imsipfx)(-)([a-fA-F0-9]*))$",
"type": "string"
}
},
"required": ["list"],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"ds": "Abc123",
"feature": "Feature1",
"list": "Ccnc",
"p1": "prepaidno",
"p2": "idprcdpn",
"scpgta": "1234"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/commonscreeninglists
Adds a new Common Screening List to the VSTP configuration. The Common Screening List name must be unique across all Common Screening Lists at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/commonscreeninglist/commonscreeninglist.json",
"properties": {
"ds": {
"description": "Digit string. A unique string of digits that is used by the specified screening feature. Allowed length for different list is different. Ccnc : 1 to 6, Gta : 1 to 15, Skbcsm : 1 to 10, Sk : 4, Insl : 1 to 15.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"feature": {
"description": "Feature name. The name of the enabled feature for which the command is entered.",
"enum" : [
"idp_screening",
"idp_query_rely"
],
"type": "string"
},
"list": {
"description": "The name of the Common Screening List associated with the feature.",
"enum" : [
"Ccnc",
"Gta",
"Skbcsm",
"Sk",
"Insl",
"Imsipfx"
],
"default": "Imsipfx",
"type": "string"
},
"p1": {
"description": "Parameter Value 1. This parameter is specific to the feature and list that use the parameter. Allowed values are prepaid1 contibued to prepaid32 and prepaidno",
"maxLength": 10,
"pattern": "^([a-zA-Z0-9]*)$",
"default": "prepaidno",
"type": "string"
},
"p2": {
"description": "Parameter Value 2.Allowed values are idprcdpn, idprcdpn2, idprcdpn3, idprcdpn4 only.",
"maxLength": 10,
"pattern": "^([a-zA-Z0-9]*)$",
"default": "idprcdpn",
"type": "string"
},
"scpgta": {
"description": "Signaling Control Point (SCP) Global Title Address (GTA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this common screening list. The unique identifier value is a combination of feature, list and ds.",
"readOnly": true,
"pattern": "^((idp_screening|idp_service_key|idp_query_rely)(-)(Ccnc|Delpfx|Gta|Skbcsm|Sk|Insl|Vmpfx|Npflgrst|Trig|Npbypass|Imsipfx)(-)([a-fA-F0-9]*))$",
"type": "string"
}
},
"required": ["list"],
"type": "object"
}
Example
{
"ds": "Abc123",
"feature": "Feature1",
"list": "Ccnc",
"p1": "prepaidno",
"p2": "idprcdpn",
"scpgta": "1234"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/commonscreeninglists/{screensetname}
get /vstp/commonscreeninglists/{screensetname}
Returns the configuration details for the specified Common Screening List. If the Common Screening List does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- screensetname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/commonscreeninglistItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/commonscreeninglist/commonscreeninglist.json",
"properties": {
"ds": {
"description": "Digit string. A unique string of digits that is used by the specified screening feature. Allowed length for different list is different. Ccnc : 1 to 6, Gta : 1 to 15, Skbcsm : 1 to 10, Sk : 4, Insl : 1 to 15.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"feature": {
"description": "Feature name. The name of the enabled feature for which the command is entered.",
"enum" : [
"idp_screening",
"idp_query_rely"
],
"type": "string"
},
"list": {
"description": "The name of the Common Screening List associated with the feature.",
"enum" : [
"Ccnc",
"Gta",
"Skbcsm",
"Sk",
"Insl",
"Imsipfx"
],
"default": "Imsipfx",
"type": "string"
},
"p1": {
"description": "Parameter Value 1. This parameter is specific to the feature and list that use the parameter. Allowed values are prepaid1 contibued to prepaid32 and prepaidno",
"maxLength": 10,
"pattern": "^([a-zA-Z0-9]*)$",
"default": "prepaidno",
"type": "string"
},
"p2": {
"description": "Parameter Value 2.Allowed values are idprcdpn, idprcdpn2, idprcdpn3, idprcdpn4 only.",
"maxLength": 10,
"pattern": "^([a-zA-Z0-9]*)$",
"default": "idprcdpn",
"type": "string"
},
"scpgta": {
"description": "Signaling Control Point (SCP) Global Title Address (GTA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this common screening list. The unique identifier value is a combination of feature, list and ds.",
"readOnly": true,
"pattern": "^((idp_screening|idp_service_key|idp_query_rely)(-)(Ccnc|Delpfx|Gta|Skbcsm|Sk|Insl|Vmpfx|Npflgrst|Trig|Npbypass|Imsipfx)(-)([a-fA-F0-9]*))$",
"type": "string"
}
},
"required": ["list"],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ds": "Abc123",
"feature": "Feature1",
"list": "Ccnc",
"p1": "prepaidno",
"p2": "idprcdpn",
"scpgta": "1234"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/commonscreeninglists/{screensetname}
Update the commonscreeninglist
Secured by x-other
delete /vstp/commonscreeninglists/{screensetname}
Deletes the specified Common Screening List from the SOAM configuration. A Common Screening List can only be deleted if all delete validation checks pass. An attempt to delete a Common Screening List that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- screensetname: required (string)
Vstp: Default Conversions
A Default Conversion entry consists of parameters such as dir, gtixlat, tta, tti, nai, np and other conversion-specific data.
All configuration of the Default Conversions is done at the SOAM.
/vstp/defaultconversions
get /vstp/defaultconversions
Returns all Default Conversions that meet the criteria specified in the GET request. By default, all Default Conversions configured at the SOAM are returned. If paging parameters are supplied, only those Default Conversions meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/defaultconversionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/defaultconversion/defaultconversion.json",
"properties": {
"dir": {
"description": "Direction of conversion.",
"enum": [
"Atoi",
"Itoa",
"Both"
],
"type": "string"
},
"gtixlat": {
"description": "Global Title Indicator conversion.",
"enum": [
22,
24
],
"type": "integer"
},
"tta": {
"description": "ANSI translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"tti": {
"description": "ITU translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"nai": {
"description": "Nature of address indicator. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified.",
"maxLength": 2,
"pattern": "^(([0-5]?[0-9])|([6][0-3]))$|^[*]$",
"type": "string"
},
"name": {
"description": "Name of default conversion.",
"maxLength": 20,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"np": {
"description": "Numbering plan. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified",
"maxLength": 2,
"pattern": "^(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted. These digits will be replaced with the new prefix digits string (npds).",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The new prefix digits string that will replace the received prefix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. This parameter identifies the new suffix digits to be deleted that will replace the received suffix digits to be deleted.",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The new suffix digits string that will replace the received suffix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
}
},
"required": [
"name",
"dir",
"gtixlat",
"tta",
"tti"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "Cnv1",
"dir": "Both",
"gtixlat": 24,
"tta": "10",
"tti": "20",
"nai": "55",
"np": "10",
"npdd": 10,
"npds": "1569"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/defaultconversions
Adds a new Default Conversion to the VSTP configuration. The Default Conversion name must be unique across all Default Conversions at the SOAM. Default Conversion Id can not be specified as fallback.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/defaultconversion/defaultconversion.json",
"properties": {
"dir": {
"description": "Direction of conversion.",
"enum": [
"Atoi",
"Itoa",
"Both"
],
"type": "string"
},
"gtixlat": {
"description": "Global Title Indicator conversion.",
"enum": [
22,
24
],
"type": "integer"
},
"tta": {
"description": "ANSI translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"tti": {
"description": "ITU translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"nai": {
"description": "Nature of address indicator. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified.",
"maxLength": 2,
"pattern": "^(([0-5]?[0-9])|([6][0-3]))$|^[*]$",
"type": "string"
},
"name": {
"description": "Name of default conversion.",
"maxLength": 20,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"np": {
"description": "Numbering plan. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified",
"maxLength": 2,
"pattern": "^(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted. These digits will be replaced with the new prefix digits string (npds).",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The new prefix digits string that will replace the received prefix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. This parameter identifies the new suffix digits to be deleted that will replace the received suffix digits to be deleted.",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The new suffix digits string that will replace the received suffix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
}
},
"required": [
"name",
"dir",
"gtixlat",
"tta",
"tti"
],
"type": "object"
}
Example
{
"name": "Cnv1",
"dir": "Both",
"gtixlat": 24,
"tta": "10",
"tti": "20",
"nai": "55",
"np": "10",
"npdd": 10,
"npds": "1569"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/defaultconversions/{name}
get /vstp/defaultconversions/{name}
Returns the configuration details for the specified Default Conversion. If the Default Conversion does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/defaultconversionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/defaultconversion/defaultconversion.json",
"properties": {
"dir": {
"description": "Direction of conversion.",
"enum": [
"Atoi",
"Itoa",
"Both"
],
"type": "string"
},
"gtixlat": {
"description": "Global Title Indicator conversion.",
"enum": [
22,
24
],
"type": "integer"
},
"tta": {
"description": "ANSI translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"tti": {
"description": "ITU translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"nai": {
"description": "Nature of address indicator. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified.",
"maxLength": 2,
"pattern": "^(([0-5]?[0-9])|([6][0-3]))$|^[*]$",
"type": "string"
},
"name": {
"description": "Name of default conversion.",
"maxLength": 20,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"np": {
"description": "Numbering plan. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified",
"maxLength": 2,
"pattern": "^(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted. These digits will be replaced with the new prefix digits string (npds).",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The new prefix digits string that will replace the received prefix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. This parameter identifies the new suffix digits to be deleted that will replace the received suffix digits to be deleted.",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The new suffix digits string that will replace the received suffix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
}
},
"required": [
"name",
"dir",
"gtixlat",
"tta",
"tti"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "Cnv1",
"dir": "Both",
"gtixlat": 24,
"tta": "10",
"tti": "20",
"nai": "55",
"np": "10",
"npdd": 10,
"npds": "1569"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/defaultconversions/{name}
Updates the configuration of the specified Default Conversion. If the provided Default Conversion data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/defaultconversion/defaultconversion.json",
"properties": {
"dir": {
"description": "Direction of conversion.",
"enum": [
"Atoi",
"Itoa",
"Both"
],
"type": "string"
},
"gtixlat": {
"description": "Global Title Indicator conversion.",
"enum": [
22,
24
],
"type": "integer"
},
"tta": {
"description": "ANSI translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"tti": {
"description": "ITU translation type.",
"maxLength": 3,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"nai": {
"description": "Nature of address indicator. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified.",
"maxLength": 2,
"pattern": "^(([0-5]?[0-9])|([6][0-3]))$|^[*]$",
"type": "string"
},
"name": {
"description": "Name of default conversion.",
"maxLength": 20,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"np": {
"description": "Numbering plan. This parameter is mandatory when gtixlat=24 is specified, and not specified when gtixlat=22 is specified",
"maxLength": 2,
"pattern": "^(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted. These digits will be replaced with the new prefix digits string (npds).",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The new prefix digits string that will replace the received prefix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. This parameter identifies the new suffix digits to be deleted that will replace the received suffix digits to be deleted.",
"maximum": 21,
"minimum": 0,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The new suffix digits string that will replace the received suffix digits string.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
}
},
"required": [
"name",
"dir",
"gtixlat",
"tta",
"tti"
],
"type": "object"
}
Example
{
"name": "Cnv1",
"dir": "Both",
"gtixlat": 24,
"tta": "10",
"tti": "20",
"nai": "55",
"np": "10",
"npdd": 10,
"npds": "1569"
}
delete /vstp/defaultconversions/{name}
Deletes the specified Default Conversion from the SOAM configuration. An attempt to delete a Default Conversion which does not exist results in an error message returned within the HTTP response. Default Conversion cannot be removed if already used by Default Conversion Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Feature Admin States
Feature Admin States provides the administrative state of the VSTP Features. The VSTP Features are initially in the disabled administrative state when the system is installed.
All administrative state changes of the VSTP Features are done at the SOAM.
/vstp/featureadminstates
get /vstp/featureadminstates
Returns the administrative state of all the VSTP-provided Features that meet the criteria specified in a valid GET request.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOTEQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOTEQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=FGTTLS
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/featureadminstateCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schema/featureadminstate/featureadminstate.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "The name of the VSTP Feature. MMI clients never define VSTP Feature names, but instead discover the available names from the collection GET response. A client must then use the VSTP-provided Feature name string when making a GET or PUT request for a particular Feature.",
"type": "string"
},
"adminState": {
"description": "A VSTP Feature's administrative state can either be Enabled or Disabled. A VSTP Feature is initially in the Disabled administrative state when the system is installed and it cannot be Disabled once Enabled.",
"enum": [
"Disabled",
"Enabled"
],
"type": "string"
}
},
"required": [
"name",
"adminState"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "300",
"name": "FGTTLS",
"adminState": "Enabled"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/vstp/featureadminstates/{name}
get /vstp/featureadminstates/{name}
Returns the administrative state for the specified VSTP Feature. If the VSTP Feature does not exist, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/featureadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schema/featureadminstate/featureadminstate.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "The name of the VSTP Feature. MMI clients never define VSTP Feature names, but instead discover the available names from the collection GET response. A client must then use the VSTP-provided Feature name string when making a GET or PUT request for a particular Feature.",
"type": "string"
},
"adminState": {
"description": "A VSTP Feature's administrative state can either be Enabled or Disabled. A VSTP Feature is initially in the Disabled administrative state when the system is installed and it cannot be Disabled once Enabled.",
"enum": [
"Disabled",
"Enabled"
],
"type": "string"
}
},
"required": [
"name",
"adminState"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "300",
"name": "FGTTLS",
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/featureadminstates/{name}
Updates the administrative state of the specified VSTP Feature. If the provided administrative state value is not valid, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/featureadminstate/featureadminstate.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"name": {
"description": "The name of the VSTP Feature. MMI clients never define VSTP Feature names, but instead discover the available names from the collection GET response. A client must then use the VSTP-provided Feature name string when making a GET or PUT request for a particular Feature.",
"type": "string"
},
"adminState": {
"description": "A VSTP Feature's administrative state can either be Enabled or Disabled. A VSTP Feature is initially in the Disabled administrative state when the system is installed and it cannot be Disabled once Enabled.",
"enum": [
"Disabled",
"Enabled"
],
"type": "string"
}
},
"required": [
"name",
"adminState"
],
"type": "object"
}
Example
{
"configurationLevel": "300",
"name": "FGTTLS",
"adminState": "Enabled"
}
Vstp: Global Title Addresses
A Global Title Address (GTA) is an entity assigned to the GTT Set (/vstp/gttsets) and GTT Selector (/vstp/gttselectors).
All configuration of GTA is done at the SOAM.
/vstp/globaltitleaddresses
get /vstp/globaltitleaddresses
Returns all GTAs that meet the criteria specified in the GET request. By default, all GTAs configured at the SOAM are returned. If paging parameters are supplied, only those GTAs meeting the request parameters are returned. This API supports filtering on gttSetName along with the following combination (startAddress-endAddress) or (smapaddr-emapaddr) or (cdssn-ecdssn) or (cgssn-ecgssn) or cgpc or opc or (opcode-pkgtype-family) or (opcode-pkgtype-acn). The gttSetName attribute can be filtered using EQUAL, NOTEQUAL, or LIKE, while the other attributes can be filtered using only EQUAL or NOTEQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=gttSetName
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=GttSet1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/gttaddressCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gta/gta.json",
"properties": {
"acn": {
"description": "Application context name. This parameter specifies the ITU TCAP acn field in the incoming MSU. The acn supports up to 7 subfields separated by dash (e.g., 1-202-33-104-54-26-007).",
"maxLength": 27,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^(((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))-){1,6}(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5])))$|^([*])$|^(None)$",
"type": "string"
},
"actsn": {
"description": "GTT Action Set Name (/vstp/gttactionsetnames). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$|^(None)$",
"type": "string"
},
"ccgt": {
"description": "Cancel called global title indicator.",
"default": "false",
"type": "boolean"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"cdselid": {
"description": "CdPA Selector ID (/vstp/gttselectors). ",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cdssn": {
"description": "Starting CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cgcnvsn": {
"description": "CgPA conversion Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcaction": {
"description": "This parameter is used to provide the required abilities, indicating what any particular translation needs to do with CgPA PC.",
"enum": [
"Dflt",
"Ignore",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"cgselid": {
"description": "CgPA Selector ID (/vstp/gttselectors).",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cgssn": {
"description": "Starting CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defmapvr": {
"description": "Default MAP version for MBR opcodes. This parameter is used to provide the default MAP version for supported MBR opcodes if Application Context Name (acn) is not present in an incoming MAP message.",
"enum": [
"None",
"V1",
"V2",
"V3"
],
"default": "None",
"type": "string"
},
"domain": {
"description": "This defines the type of SS7 domain. This is applicable to cgpc and opc.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"ecdssn": {
"description": "Ending CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"ecgssn": {
"description": "Ending CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"emapaddr": {
"description": "MAP End Address (similar to endAddress). This parameter specifies the end of a range of MAP digits (IMSI/MSISDN).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"endAddress": {
"description": "End global title address. This parameter specifies the end of a range of global title digits.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"fallback": {
"description": "Fallback option. The action taken when the final translation does not match while performing GTT using a FLOBR-specific GTT mode.",
"enum": [
"Sysdflt",
"Yes",
"No"
],
"default": "Sysdflt",
"type": "string"
},
"family": {
"description": "The ANSI TCAP family field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"gtmodName": {
"description": "Defines the GT Mod name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"gttSetName": {
"description": "Defines the GTT Set name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with Global title address, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"lspName": {
"description": "Defines the Local Signaling Point name (/vstp/localsignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Defines the Map Set identifier associated with this Global Title Address (GTA). MAP Set id is a Mated Application set ID. MAP Set id is mandatory when routingIndicator is set to SSN.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "Defines the Mated Relay Node (MRN) Set name associated with this Global Title Address (GTA). mrnSetId is the MRN Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"opc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"opcode": {
"description": "The TCAP opcode field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"opcsn": {
"description": "The OPC GTT set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"optsn": {
"description": "Optional gtt set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"pkgtype": {
"description": "The ANSI and ITU TCAP package type.",
"enum": [
"Bgn",
"End",
"Cnt",
"Ituabort",
"Ituuni",
"Qwp",
"Qwop",
"Resp",
"Cwp",
"Cwop",
"Ansiabort",
"Ansiuni",
"Any"
],
"default": "Invalidpkgtype",
"type": "string"
},
"routingIndicator": {
"description": "Routing indicator. GT allow a called party address with a routing indicator value of 'global title'. SSN allow a called party address with a routing indicator value of 'DPC/SSN'.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"smapaddr": {
"description": "Start Address (similar to startAddress). This parameter specifies the beginning of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"startAddress": {
"description": "Defines the start of a range of this Global Title Address. This specifies the start of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"splitAction": {
"description": "Splitting of address range is not supported in GTA.",
"enum": [
"None"
],
"type": "string"
},
"subsystem": {
"description": "New translated subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"translateIndicator": {
"description": "Defines translation actions and routing actions for this Global Title Address (GTA). If translationIndicator is set as None, either startAddress or endAddress, and gttSetName should be set. If translateIndicator is set as Dpc, then routingIndicator, rspName, subsystem, mapSetId, and mrnSetId should be set. If translateIndicator is set as Dpcngt, then routingIndicator is set as Gt. If translateIndicator is set as Dpcssn, then routingIndicator is set as Ssn.",
"enum": [
"Dpc",
"Dpcngt",
"Dpcssn",
"None"
],
"type": "string"
},
"alwmulcomp": {
"description": "Allow Multiple Components. This parameter specifies if a certain component/opcode is required to be processed in multicomponent packet.",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"prio": {
"description": "Priority, is used to select translation when multicomponent packet is received. 1024 has the lowest priority and 1 being highest priority. By default value will remain 1024.",
"maximum": 1024,
"minimum": 1,
"default": 1024,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this Global Title Address (GTA). This Unique identifier value will be used for PUT and DELETE operations. Unique identifier for GTA can be auto generated UUID or unique combination of GTT Set Name and different GTA properties. We can fetch auto generated Unique Identifer (UUID) from MMI Get response. Also, User can formulate Unique Identifer by combining GTT Set Name and different GTA properties separated by colon. For example Unique Identifier for GTA Opcode can be (gttSetName:acn/family:pkgType:opcode:ITU/ANSI) where ITU and ANSI can be used to determine second attribute is acn or famliy respectively. Similarly Unique Identifier for CGPAPC GTA can be (gttSetName:cgpc:domain) and for OPC GTA can be (gttSetName:opc:domain). Unique Identifier for CDPAGTA and CGPAGTA can be (gttSetName:startAddress) and for MBR GTA can be (gttSetName:smapaddr). Unique Identifier for CDPASSN GTA can be (gttSetName:cdssn) and for CGPASSN GTA can be (gttSetName:cgssn).",
"maxLength": 54,
"readOnly": true,
"type": "string"
}
},
"required": [
"gttSetName",
"translateIndicator"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"actsn": "actSn1",
"cdselid": 1,
"cgGtmod": false,
"endAddress": "2234567891",
"fallback": "No",
"gttSetName": "ANSI1",
"gtmodName": "gtMod1",
"loopSetName": "loopset1",
"mapSetId": 1,
"routingIndicator": "Ssn",
"rspName": "rsp1",
"splitAction": "None",
"startAddress": "1234567891",
"subsystem": 5,
"translateIndicator": "Dpcssn"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/globaltitleaddresses
Adds a new GTA to the VSTP configuration. The GTT Set name and start address combination must be unique for inserting a new GTA assigned to a GTT Set (/vstp/gttsets) at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gta/gta.json",
"properties": {
"acn": {
"description": "Application context name. This parameter specifies the ITU TCAP acn field in the incoming MSU. The acn supports up to 7 subfields separated by dash (e.g., 1-202-33-104-54-26-007).",
"maxLength": 27,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^(((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))-){1,6}(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5])))$|^([*])$|^(None)$",
"type": "string"
},
"actsn": {
"description": "GTT Action Set Name (/vstp/gttactionsetnames). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$|^(None)$",
"type": "string"
},
"ccgt": {
"description": "Cancel called global title indicator.",
"default": "false",
"type": "boolean"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"cdselid": {
"description": "CdPA Selector ID (/vstp/gttselectors). ",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cdssn": {
"description": "Starting CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cgcnvsn": {
"description": "CgPA conversion Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcaction": {
"description": "This parameter is used to provide the required abilities, indicating what any particular translation needs to do with CgPA PC.",
"enum": [
"Dflt",
"Ignore",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"cgselid": {
"description": "CgPA Selector ID (/vstp/gttselectors).",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cgssn": {
"description": "Starting CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defmapvr": {
"description": "Default MAP version for MBR opcodes. This parameter is used to provide the default MAP version for supported MBR opcodes if Application Context Name (acn) is not present in an incoming MAP message.",
"enum": [
"None",
"V1",
"V2",
"V3"
],
"default": "None",
"type": "string"
},
"domain": {
"description": "This defines the type of SS7 domain. This is applicable to cgpc and opc.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"ecdssn": {
"description": "Ending CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"ecgssn": {
"description": "Ending CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"emapaddr": {
"description": "MAP End Address (similar to endAddress). This parameter specifies the end of a range of MAP digits (IMSI/MSISDN).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"endAddress": {
"description": "End global title address. This parameter specifies the end of a range of global title digits.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"fallback": {
"description": "Fallback option. The action taken when the final translation does not match while performing GTT using a FLOBR-specific GTT mode.",
"enum": [
"Sysdflt",
"Yes",
"No"
],
"default": "Sysdflt",
"type": "string"
},
"family": {
"description": "The ANSI TCAP family field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"gtmodName": {
"description": "Defines the GT Mod name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"gttSetName": {
"description": "Defines the GTT Set name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with Global title address, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"lspName": {
"description": "Defines the Local Signaling Point name (/vstp/localsignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Defines the Map Set identifier associated with this Global Title Address (GTA). MAP Set id is a Mated Application set ID. MAP Set id is mandatory when routingIndicator is set to SSN.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "Defines the Mated Relay Node (MRN) Set name associated with this Global Title Address (GTA). mrnSetId is the MRN Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"opc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"opcode": {
"description": "The TCAP opcode field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"opcsn": {
"description": "The OPC GTT set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"optsn": {
"description": "Optional gtt set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"pkgtype": {
"description": "The ANSI and ITU TCAP package type.",
"enum": [
"Bgn",
"End",
"Cnt",
"Ituabort",
"Ituuni",
"Qwp",
"Qwop",
"Resp",
"Cwp",
"Cwop",
"Ansiabort",
"Ansiuni",
"Any"
],
"default": "Invalidpkgtype",
"type": "string"
},
"routingIndicator": {
"description": "Routing indicator. GT allow a called party address with a routing indicator value of 'global title'. SSN allow a called party address with a routing indicator value of 'DPC/SSN'.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"smapaddr": {
"description": "Start Address (similar to startAddress). This parameter specifies the beginning of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"startAddress": {
"description": "Defines the start of a range of this Global Title Address. This specifies the start of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"splitAction": {
"description": "Splitting of address range is not supported in GTA.",
"enum": [
"None"
],
"type": "string"
},
"subsystem": {
"description": "New translated subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"translateIndicator": {
"description": "Defines translation actions and routing actions for this Global Title Address (GTA). If translationIndicator is set as None, either startAddress or endAddress, and gttSetName should be set. If translateIndicator is set as Dpc, then routingIndicator, rspName, subsystem, mapSetId, and mrnSetId should be set. If translateIndicator is set as Dpcngt, then routingIndicator is set as Gt. If translateIndicator is set as Dpcssn, then routingIndicator is set as Ssn.",
"enum": [
"Dpc",
"Dpcngt",
"Dpcssn",
"None"
],
"type": "string"
},
"alwmulcomp": {
"description": "Allow Multiple Components. This parameter specifies if a certain component/opcode is required to be processed in multicomponent packet.",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"prio": {
"description": "Priority, is used to select translation when multicomponent packet is received. 1024 has the lowest priority and 1 being highest priority. By default value will remain 1024.",
"maximum": 1024,
"minimum": 1,
"default": 1024,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this Global Title Address (GTA). This Unique identifier value will be used for PUT and DELETE operations. Unique identifier for GTA can be auto generated UUID or unique combination of GTT Set Name and different GTA properties. We can fetch auto generated Unique Identifer (UUID) from MMI Get response. Also, User can formulate Unique Identifer by combining GTT Set Name and different GTA properties separated by colon. For example Unique Identifier for GTA Opcode can be (gttSetName:acn/family:pkgType:opcode:ITU/ANSI) where ITU and ANSI can be used to determine second attribute is acn or famliy respectively. Similarly Unique Identifier for CGPAPC GTA can be (gttSetName:cgpc:domain) and for OPC GTA can be (gttSetName:opc:domain). Unique Identifier for CDPAGTA and CGPAGTA can be (gttSetName:startAddress) and for MBR GTA can be (gttSetName:smapaddr). Unique Identifier for CDPASSN GTA can be (gttSetName:cdssn) and for CGPASSN GTA can be (gttSetName:cgssn).",
"maxLength": 54,
"readOnly": true,
"type": "string"
}
},
"required": [
"gttSetName",
"translateIndicator"
],
"type": "object"
}
Example
{
"actsn": "actSn1",
"cdselid": 1,
"cgGtmod": false,
"endAddress": "2234567891",
"fallback": "No",
"gttSetName": "ANSI1",
"gtmodName": "gtMod1",
"loopSetName": "loopset1",
"mapSetId": 1,
"routingIndicator": "Ssn",
"rspName": "rsp1",
"splitAction": "None",
"startAddress": "1234567891",
"subsystem": 5,
"translateIndicator": "Dpcssn"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/globaltitleaddresses/{uniqueIdentifier}
get /vstp/globaltitleaddresses/{uniqueIdentifier}
Returns the configuration details for the specified GTA. If the GTA does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/gttaddressItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gta/gta.json",
"properties": {
"acn": {
"description": "Application context name. This parameter specifies the ITU TCAP acn field in the incoming MSU. The acn supports up to 7 subfields separated by dash (e.g., 1-202-33-104-54-26-007).",
"maxLength": 27,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^(((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))-){1,6}(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5])))$|^([*])$|^(None)$",
"type": "string"
},
"actsn": {
"description": "GTT Action Set Name (/vstp/gttactionsetnames). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$|^(None)$",
"type": "string"
},
"ccgt": {
"description": "Cancel called global title indicator.",
"default": "false",
"type": "boolean"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"cdselid": {
"description": "CdPA Selector ID (/vstp/gttselectors). ",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cdssn": {
"description": "Starting CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cgcnvsn": {
"description": "CgPA conversion Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcaction": {
"description": "This parameter is used to provide the required abilities, indicating what any particular translation needs to do with CgPA PC.",
"enum": [
"Dflt",
"Ignore",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"cgselid": {
"description": "CgPA Selector ID (/vstp/gttselectors).",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cgssn": {
"description": "Starting CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defmapvr": {
"description": "Default MAP version for MBR opcodes. This parameter is used to provide the default MAP version for supported MBR opcodes if Application Context Name (acn) is not present in an incoming MAP message.",
"enum": [
"None",
"V1",
"V2",
"V3"
],
"default": "None",
"type": "string"
},
"domain": {
"description": "This defines the type of SS7 domain. This is applicable to cgpc and opc.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"ecdssn": {
"description": "Ending CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"ecgssn": {
"description": "Ending CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"emapaddr": {
"description": "MAP End Address (similar to endAddress). This parameter specifies the end of a range of MAP digits (IMSI/MSISDN).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"endAddress": {
"description": "End global title address. This parameter specifies the end of a range of global title digits.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"fallback": {
"description": "Fallback option. The action taken when the final translation does not match while performing GTT using a FLOBR-specific GTT mode.",
"enum": [
"Sysdflt",
"Yes",
"No"
],
"default": "Sysdflt",
"type": "string"
},
"family": {
"description": "The ANSI TCAP family field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"gtmodName": {
"description": "Defines the GT Mod name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"gttSetName": {
"description": "Defines the GTT Set name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with Global title address, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"lspName": {
"description": "Defines the Local Signaling Point name (/vstp/localsignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Defines the Map Set identifier associated with this Global Title Address (GTA). MAP Set id is a Mated Application set ID. MAP Set id is mandatory when routingIndicator is set to SSN.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "Defines the Mated Relay Node (MRN) Set name associated with this Global Title Address (GTA). mrnSetId is the MRN Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"opc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"opcode": {
"description": "The TCAP opcode field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"opcsn": {
"description": "The OPC GTT set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"optsn": {
"description": "Optional gtt set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"pkgtype": {
"description": "The ANSI and ITU TCAP package type.",
"enum": [
"Bgn",
"End",
"Cnt",
"Ituabort",
"Ituuni",
"Qwp",
"Qwop",
"Resp",
"Cwp",
"Cwop",
"Ansiabort",
"Ansiuni",
"Any"
],
"default": "Invalidpkgtype",
"type": "string"
},
"routingIndicator": {
"description": "Routing indicator. GT allow a called party address with a routing indicator value of 'global title'. SSN allow a called party address with a routing indicator value of 'DPC/SSN'.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"smapaddr": {
"description": "Start Address (similar to startAddress). This parameter specifies the beginning of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"startAddress": {
"description": "Defines the start of a range of this Global Title Address. This specifies the start of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"splitAction": {
"description": "Splitting of address range is not supported in GTA.",
"enum": [
"None"
],
"type": "string"
},
"subsystem": {
"description": "New translated subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"translateIndicator": {
"description": "Defines translation actions and routing actions for this Global Title Address (GTA). If translationIndicator is set as None, either startAddress or endAddress, and gttSetName should be set. If translateIndicator is set as Dpc, then routingIndicator, rspName, subsystem, mapSetId, and mrnSetId should be set. If translateIndicator is set as Dpcngt, then routingIndicator is set as Gt. If translateIndicator is set as Dpcssn, then routingIndicator is set as Ssn.",
"enum": [
"Dpc",
"Dpcngt",
"Dpcssn",
"None"
],
"type": "string"
},
"alwmulcomp": {
"description": "Allow Multiple Components. This parameter specifies if a certain component/opcode is required to be processed in multicomponent packet.",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"prio": {
"description": "Priority, is used to select translation when multicomponent packet is received. 1024 has the lowest priority and 1 being highest priority. By default value will remain 1024.",
"maximum": 1024,
"minimum": 1,
"default": 1024,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this Global Title Address (GTA). This Unique identifier value will be used for PUT and DELETE operations. Unique identifier for GTA can be auto generated UUID or unique combination of GTT Set Name and different GTA properties. We can fetch auto generated Unique Identifer (UUID) from MMI Get response. Also, User can formulate Unique Identifer by combining GTT Set Name and different GTA properties separated by colon. For example Unique Identifier for GTA Opcode can be (gttSetName:acn/family:pkgType:opcode:ITU/ANSI) where ITU and ANSI can be used to determine second attribute is acn or famliy respectively. Similarly Unique Identifier for CGPAPC GTA can be (gttSetName:cgpc:domain) and for OPC GTA can be (gttSetName:opc:domain). Unique Identifier for CDPAGTA and CGPAGTA can be (gttSetName:startAddress) and for MBR GTA can be (gttSetName:smapaddr). Unique Identifier for CDPASSN GTA can be (gttSetName:cdssn) and for CGPASSN GTA can be (gttSetName:cgssn).",
"maxLength": 54,
"readOnly": true,
"type": "string"
}
},
"required": [
"gttSetName",
"translateIndicator"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"actsn": "actSn1",
"cdselid": 1,
"cgGtmod": false,
"endAddress": "2234567891",
"fallback": "No",
"gttSetName": "ANSI1",
"gtmodName": "gtMod1",
"loopSetName": "loopset1",
"mapSetId": 1,
"routingIndicator": "Ssn",
"rspName": "rsp1",
"splitAction": "None",
"startAddress": "1234567891",
"subsystem": 5,
"translateIndicator": "Dpcssn"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/globaltitleaddresses/{uniqueIdentifier}
Updates the configuration of the specified GTA. If the provided GTA data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response. If the input start and end address values differ from the existing address values of the GTA, splitting of the GTA takes place.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gta/gta.json",
"properties": {
"acn": {
"description": "Application context name. This parameter specifies the ITU TCAP acn field in the incoming MSU. The acn supports up to 7 subfields separated by dash (e.g., 1-202-33-104-54-26-007).",
"maxLength": 27,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^(((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))-){1,6}(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5])))$|^([*])$|^(None)$",
"type": "string"
},
"actsn": {
"description": "GTT Action Set Name (/vstp/gttactionsetnames). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$|^(None)$",
"type": "string"
},
"ccgt": {
"description": "Cancel called global title indicator.",
"default": "false",
"type": "boolean"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"cdselid": {
"description": "CdPA Selector ID (/vstp/gttselectors). ",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cdssn": {
"description": "Starting CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cgcnvsn": {
"description": "CgPA conversion Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcaction": {
"description": "This parameter is used to provide the required abilities, indicating what any particular translation needs to do with CgPA PC.",
"enum": [
"Dflt",
"Ignore",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"cgselid": {
"description": "CgPA Selector ID (/vstp/gttselectors).",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"cgssn": {
"description": "Starting CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"defmapvr": {
"description": "Default MAP version for MBR opcodes. This parameter is used to provide the default MAP version for supported MBR opcodes if Application Context Name (acn) is not present in an incoming MAP message.",
"enum": [
"None",
"V1",
"V2",
"V3"
],
"default": "None",
"type": "string"
},
"domain": {
"description": "This defines the type of SS7 domain. This is applicable to cgpc and opc.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"ecdssn": {
"description": "Ending CdPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"ecgssn": {
"description": "Ending CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"emapaddr": {
"description": "MAP End Address (similar to endAddress). This parameter specifies the end of a range of MAP digits (IMSI/MSISDN).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"endAddress": {
"description": "End global title address. This parameter specifies the end of a range of global title digits.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"fallback": {
"description": "Fallback option. The action taken when the final translation does not match while performing GTT using a FLOBR-specific GTT mode.",
"enum": [
"Sysdflt",
"Yes",
"No"
],
"default": "Sysdflt",
"type": "string"
},
"family": {
"description": "The ANSI TCAP family field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"gtmodName": {
"description": "Defines the GT Mod name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"gttSetName": {
"description": "Defines the GTT Set name associated with this Global Title Address (GTA). 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with Global title address, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"lspName": {
"description": "Defines the Local Signaling Point name (/vstp/localsignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Defines the Map Set identifier associated with this Global Title Address (GTA). MAP Set id is a Mated Application set ID. MAP Set id is mandatory when routingIndicator is set to SSN.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "Defines the Mated Relay Node (MRN) Set name associated with this Global Title Address (GTA). mrnSetId is the MRN Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"opc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp).",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"opcode": {
"description": "The TCAP opcode field in the incoming MSU.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"type": "string"
},
"opcsn": {
"description": "The OPC GTT set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"optsn": {
"description": "Optional gtt set name. 1 leading alphabetic character and up to 8 following alphanumeric characters",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"pkgtype": {
"description": "The ANSI and ITU TCAP package type.",
"enum": [
"Bgn",
"End",
"Cnt",
"Ituabort",
"Ituuni",
"Qwp",
"Qwop",
"Resp",
"Cwp",
"Cwop",
"Ansiabort",
"Ansiuni",
"Any"
],
"default": "Invalidpkgtype",
"type": "string"
},
"routingIndicator": {
"description": "Routing indicator. GT allow a called party address with a routing indicator value of 'global title'. SSN allow a called party address with a routing indicator value of 'DPC/SSN'.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"smapaddr": {
"description": "Start Address (similar to startAddress). This parameter specifies the beginning of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"startAddress": {
"description": "Defines the start of a range of this Global Title Address. This specifies the start of a range of MAP digits (IMSI/MSISDN/VLRNB/SMRPOA/SMRPDA).",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"splitAction": {
"description": "Splitting of address range is not supported in GTA.",
"enum": [
"None"
],
"type": "string"
},
"subsystem": {
"description": "New translated subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"translateIndicator": {
"description": "Defines translation actions and routing actions for this Global Title Address (GTA). If translationIndicator is set as None, either startAddress or endAddress, and gttSetName should be set. If translateIndicator is set as Dpc, then routingIndicator, rspName, subsystem, mapSetId, and mrnSetId should be set. If translateIndicator is set as Dpcngt, then routingIndicator is set as Gt. If translateIndicator is set as Dpcssn, then routingIndicator is set as Ssn.",
"enum": [
"Dpc",
"Dpcngt",
"Dpcssn",
"None"
],
"type": "string"
},
"alwmulcomp": {
"description": "Allow Multiple Components. This parameter specifies if a certain component/opcode is required to be processed in multicomponent packet.",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"prio": {
"description": "Priority, is used to select translation when multicomponent packet is received. 1024 has the lowest priority and 1 being highest priority. By default value will remain 1024.",
"maximum": 1024,
"minimum": 1,
"default": 1024,
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this Global Title Address (GTA). This Unique identifier value will be used for PUT and DELETE operations. Unique identifier for GTA can be auto generated UUID or unique combination of GTT Set Name and different GTA properties. We can fetch auto generated Unique Identifer (UUID) from MMI Get response. Also, User can formulate Unique Identifer by combining GTT Set Name and different GTA properties separated by colon. For example Unique Identifier for GTA Opcode can be (gttSetName:acn/family:pkgType:opcode:ITU/ANSI) where ITU and ANSI can be used to determine second attribute is acn or famliy respectively. Similarly Unique Identifier for CGPAPC GTA can be (gttSetName:cgpc:domain) and for OPC GTA can be (gttSetName:opc:domain). Unique Identifier for CDPAGTA and CGPAGTA can be (gttSetName:startAddress) and for MBR GTA can be (gttSetName:smapaddr). Unique Identifier for CDPASSN GTA can be (gttSetName:cdssn) and for CGPASSN GTA can be (gttSetName:cgssn).",
"maxLength": 54,
"readOnly": true,
"type": "string"
}
},
"required": [
"gttSetName",
"translateIndicator"
],
"type": "object"
}
Example
{
"actsn": "actSn1",
"cdselid": 1,
"cgGtmod": false,
"endAddress": "2234567891",
"fallback": "No",
"gttSetName": "ANSI1",
"gtmodName": "gtMod1",
"loopSetName": "loopset1",
"mapSetId": 1,
"routingIndicator": "Ssn",
"rspName": "rsp1",
"splitAction": "None",
"startAddress": "1234567891",
"subsystem": 5,
"translateIndicator": "Dpcssn"
}
delete /vstp/globaltitleaddresses/{uniqueIdentifier}
Deletes the specified GTA from the SOAM configuration. A GTA can only be deleted if all delete validation checks pass. In general, if the GTA is associated with GTT Set (/vstp/gttsets) or Selector (/vstp/gttselectors), the GTA cannot be deleted. An attempt to delete a GTA that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Vstp: GTT Actions
A GTT Action entry consists of an Action ID, an action, and action-specific data. The action specified in the entry determines the actions to be performed on MSU during translation.
All configuration of the GTT Actions is done at the SOAM.
/vstp/gttactions
get /vstp/gttactions
Returns all GTT Actions that meet the criteria specified in the GET request. By default, all GTT Actions configured at the SOAM are returned. If paging parameters are supplied, only those GTT Actions meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/gttactionCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttaction/gttaction.json",
"properties": {
"act": {
"description": "The action applied to the message.",
"enum": [
"Disc",
"Dup",
"Fwd",
"Scpval",
"Sfthrot",
"Tcaperr",
"Sfapp",
"Udts"
],
"type": "string"
},
"handlresp": {
"description": "Handle Response",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"atigtmodName": {
"description": "Calling party global title modification name for ATI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"psigtmodName": {
"description": "Calling party global title modification name for PSI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"actid": {
"description": "This parameter specifies the Action ID associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"atcaperr": {
"description": "The reason for discarding the message containing the ANSI TCAP portion that is associated with the TCAP GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cdGtmodName": {
"description": "This parameter specifies the CDPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgGtmodName": {
"description": "This parameter specifies the CGPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp)",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcogmsg": {
"description": "The data that is used as the Calling Party Point Code in the outgoing message. Dflt - The standard Global Title Translation process supplies the CgPA PC. Cgpcicmsg - CgPA PC data from the incoming MSU. Opcicmsg - OPC data from the incoming MSU. Provcgpc - provisioned CGPC data in the GTT Action. Remove - CGPC will be removed from outgoing MSU.",
"enum": [
"Dflt",
"Cgpcicmsg",
"Opcicmsg",
"Provcgpc",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"defactid": {
"description": "The default action that is performed when the fwd GTT Action fails to route the MSU. 1 leading alphabetic character followed by 8 alphanumeric characters. The defactid parameter can take one of the following values: 1)GTT Action ID with a GTT Action of disc, udts, or tcaperr. This value must already be defined in the GTT Action table. 2)fallback - The MSU is routed using routing data in the translated MSU when action is fwd.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"domain": {
"description": "This defines the type of CGPC domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"failactName": {
"description": "Fail Action Name. The default action that is performed to route the message when the VLR Validation fails on Stateful App.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"fwdgttName": {
"description": "Forward GTT. The forward GTT Action Name that is to be used to route the MSU.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"hlraddr": {
"description": "This defines address of the HLR for the ATI message.",
"enum": [
"Usecdpa",
"Tcapparm",
"Fwdact"
],
"default": "Usecdpa",
"type": "string"
},
"itcaperr": {
"description": "The reason for discarding the message containing the ITU TCAP portion that is associated with the TCAPERR GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with GTA, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "This parameter specifies the Mated Application Set ID.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "The Mated Relay Node Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"ndgt": {
"description": "Number of digits to be matched. This parameter is used to specify the number of digits that needs to be matched between SCCP parameter and MAP parameter..",
"pattern": "^(([0]?[1-9])|([1][0-9])|2[0-1])$|^(All)$",
"default": "All",
"type": "string"
},
"ri": {
"description": "The routing indicator in the SCCP called party address of the duplicated copy of MSU.",
"enum": [
"Gt",
"Ssn"
],
"default": "Ssn",
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 18,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"scfaddr": {
"description": "Defines the GSM SCFAddressparameter must be specified when sfapp action needs to be performed.",
"maxLength": 18,
"pattern": "^(([1-9][0-9]*))$",
"type": "string"
},
"sprm": {
"description": "This SCCP parameter is used to decide whether the SCCP NP, NAI and GTA shall be picked up from CDPA or CGPA for comparing.",
"enum": [
"Cggta",
"Cdgta"
],
"type": "string"
},
"ssn": {
"description": "The subsystem number in the SCCP called party address of the MSU.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"tt": {
"description": "New Translation Type.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"threshold": {
"description": "If the number of MSUs serviced by the SFTHROT action exceeds threshold value, MSUs are discarded.",
"maximum": 4294967295,
"minimum": 1,
"default": 1,
"type": "integer"
},
"taIndex": {
"description": "Throttle Action Index for Measurements",
"readOnly": true,
"type": "integer"
},
"tprm": {
"description": "This TCAP parameter is used to decide whether the MAP digits, NP and NoN shall be picked form SMRPDA or SMRPOA for comparison.",
"enum": [
"Smrpoa",
"Smrpda"
],
"type": "string"
},
"udtserr": {
"description": "The reason associated with the UDTS GTT Action for discarding the message.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"uimreqd": {
"description": "This specifies whether a UIM should be generated. When set to true, UIM is not generated.",
"default": false,
"type": "boolean"
},
"useicmsg": {
"description": "This specifies whether to apply GTT Action data to the message as the message was received (OFF).",
"type": "boolean"
},
"valType": {
"description": "This parameter is used to decide whether SCCP/TCAP parameter should be used for the validation of the MSU or IR21 data should be used for the validation of the MSU.",
"enum": [
"SccpToTcap",
"IR21ToTcap"
],
"default": "SccpToTcap",
"type": "string"
}
},
"required": [
"act",
"actid"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"act": "Fwd",
"actid": "actfwd1",
"cdGtmodName": "cdGtmod1",
"cgGtmodName": "cgGtmod1",
"loopSetName": "loopset1",
"mrnset": 10,
"ri": "Gt",
"rspName": "RSP1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/gttactions
Adds a new GTT Action to the VSTP configuration. The GTT Action name must be unique across all GTT Actions at the SOAM. GTT Action Id can not be specified as fallback.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttaction/gttaction.json",
"properties": {
"act": {
"description": "The action applied to the message.",
"enum": [
"Disc",
"Dup",
"Fwd",
"Scpval",
"Sfthrot",
"Tcaperr",
"Sfapp",
"Udts"
],
"type": "string"
},
"handlresp": {
"description": "Handle Response",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"atigtmodName": {
"description": "Calling party global title modification name for ATI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"psigtmodName": {
"description": "Calling party global title modification name for PSI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"actid": {
"description": "This parameter specifies the Action ID associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"atcaperr": {
"description": "The reason for discarding the message containing the ANSI TCAP portion that is associated with the TCAP GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cdGtmodName": {
"description": "This parameter specifies the CDPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgGtmodName": {
"description": "This parameter specifies the CGPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp)",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcogmsg": {
"description": "The data that is used as the Calling Party Point Code in the outgoing message. Dflt - The standard Global Title Translation process supplies the CgPA PC. Cgpcicmsg - CgPA PC data from the incoming MSU. Opcicmsg - OPC data from the incoming MSU. Provcgpc - provisioned CGPC data in the GTT Action. Remove - CGPC will be removed from outgoing MSU.",
"enum": [
"Dflt",
"Cgpcicmsg",
"Opcicmsg",
"Provcgpc",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"defactid": {
"description": "The default action that is performed when the fwd GTT Action fails to route the MSU. 1 leading alphabetic character followed by 8 alphanumeric characters. The defactid parameter can take one of the following values: 1)GTT Action ID with a GTT Action of disc, udts, or tcaperr. This value must already be defined in the GTT Action table. 2)fallback - The MSU is routed using routing data in the translated MSU when action is fwd.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"domain": {
"description": "This defines the type of CGPC domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"failactName": {
"description": "Fail Action Name. The default action that is performed to route the message when the VLR Validation fails on Stateful App.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"fwdgttName": {
"description": "Forward GTT. The forward GTT Action Name that is to be used to route the MSU.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"hlraddr": {
"description": "This defines address of the HLR for the ATI message.",
"enum": [
"Usecdpa",
"Tcapparm",
"Fwdact"
],
"default": "Usecdpa",
"type": "string"
},
"itcaperr": {
"description": "The reason for discarding the message containing the ITU TCAP portion that is associated with the TCAPERR GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with GTA, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "This parameter specifies the Mated Application Set ID.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "The Mated Relay Node Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"ndgt": {
"description": "Number of digits to be matched. This parameter is used to specify the number of digits that needs to be matched between SCCP parameter and MAP parameter..",
"pattern": "^(([0]?[1-9])|([1][0-9])|2[0-1])$|^(All)$",
"default": "All",
"type": "string"
},
"ri": {
"description": "The routing indicator in the SCCP called party address of the duplicated copy of MSU.",
"enum": [
"Gt",
"Ssn"
],
"default": "Ssn",
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 18,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"scfaddr": {
"description": "Defines the GSM SCFAddressparameter must be specified when sfapp action needs to be performed.",
"maxLength": 18,
"pattern": "^(([1-9][0-9]*))$",
"type": "string"
},
"sprm": {
"description": "This SCCP parameter is used to decide whether the SCCP NP, NAI and GTA shall be picked up from CDPA or CGPA for comparing.",
"enum": [
"Cggta",
"Cdgta"
],
"type": "string"
},
"ssn": {
"description": "The subsystem number in the SCCP called party address of the MSU.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"tt": {
"description": "New Translation Type.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"threshold": {
"description": "If the number of MSUs serviced by the SFTHROT action exceeds threshold value, MSUs are discarded.",
"maximum": 4294967295,
"minimum": 1,
"default": 1,
"type": "integer"
},
"taIndex": {
"description": "Throttle Action Index for Measurements",
"readOnly": true,
"type": "integer"
},
"tprm": {
"description": "This TCAP parameter is used to decide whether the MAP digits, NP and NoN shall be picked form SMRPDA or SMRPOA for comparison.",
"enum": [
"Smrpoa",
"Smrpda"
],
"type": "string"
},
"udtserr": {
"description": "The reason associated with the UDTS GTT Action for discarding the message.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"uimreqd": {
"description": "This specifies whether a UIM should be generated. When set to true, UIM is not generated.",
"default": false,
"type": "boolean"
},
"useicmsg": {
"description": "This specifies whether to apply GTT Action data to the message as the message was received (OFF).",
"type": "boolean"
},
"valType": {
"description": "This parameter is used to decide whether SCCP/TCAP parameter should be used for the validation of the MSU or IR21 data should be used for the validation of the MSU.",
"enum": [
"SccpToTcap",
"IR21ToTcap"
],
"default": "SccpToTcap",
"type": "string"
}
},
"required": [
"act",
"actid"
],
"type": "object"
}
Example
{
"act": "Fwd",
"actid": "actfwd1",
"cdGtmodName": "cdGtmod1",
"cgGtmodName": "cgGtmod1",
"loopSetName": "loopset1",
"mrnset": 10,
"ri": "Gt",
"rspName": "RSP1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/gttactions/{name}
get /vstp/gttactions/{name}
Returns the configuration details for the specified GTT Action. If the GTT Action does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/gttactionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttaction/gttaction.json",
"properties": {
"act": {
"description": "The action applied to the message.",
"enum": [
"Disc",
"Dup",
"Fwd",
"Scpval",
"Sfthrot",
"Tcaperr",
"Sfapp",
"Udts"
],
"type": "string"
},
"handlresp": {
"description": "Handle Response",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"atigtmodName": {
"description": "Calling party global title modification name for ATI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"psigtmodName": {
"description": "Calling party global title modification name for PSI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"actid": {
"description": "This parameter specifies the Action ID associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"atcaperr": {
"description": "The reason for discarding the message containing the ANSI TCAP portion that is associated with the TCAP GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cdGtmodName": {
"description": "This parameter specifies the CDPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgGtmodName": {
"description": "This parameter specifies the CGPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp)",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcogmsg": {
"description": "The data that is used as the Calling Party Point Code in the outgoing message. Dflt - The standard Global Title Translation process supplies the CgPA PC. Cgpcicmsg - CgPA PC data from the incoming MSU. Opcicmsg - OPC data from the incoming MSU. Provcgpc - provisioned CGPC data in the GTT Action. Remove - CGPC will be removed from outgoing MSU.",
"enum": [
"Dflt",
"Cgpcicmsg",
"Opcicmsg",
"Provcgpc",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"defactid": {
"description": "The default action that is performed when the fwd GTT Action fails to route the MSU. 1 leading alphabetic character followed by 8 alphanumeric characters. The defactid parameter can take one of the following values: 1)GTT Action ID with a GTT Action of disc, udts, or tcaperr. This value must already be defined in the GTT Action table. 2)fallback - The MSU is routed using routing data in the translated MSU when action is fwd.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"domain": {
"description": "This defines the type of CGPC domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"failactName": {
"description": "Fail Action Name. The default action that is performed to route the message when the VLR Validation fails on Stateful App.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"fwdgttName": {
"description": "Forward GTT. The forward GTT Action Name that is to be used to route the MSU.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"hlraddr": {
"description": "This defines address of the HLR for the ATI message.",
"enum": [
"Usecdpa",
"Tcapparm",
"Fwdact"
],
"default": "Usecdpa",
"type": "string"
},
"itcaperr": {
"description": "The reason for discarding the message containing the ITU TCAP portion that is associated with the TCAPERR GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with GTA, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "This parameter specifies the Mated Application Set ID.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "The Mated Relay Node Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"ndgt": {
"description": "Number of digits to be matched. This parameter is used to specify the number of digits that needs to be matched between SCCP parameter and MAP parameter..",
"pattern": "^(([0]?[1-9])|([1][0-9])|2[0-1])$|^(All)$",
"default": "All",
"type": "string"
},
"ri": {
"description": "The routing indicator in the SCCP called party address of the duplicated copy of MSU.",
"enum": [
"Gt",
"Ssn"
],
"default": "Ssn",
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 18,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"scfaddr": {
"description": "Defines the GSM SCFAddressparameter must be specified when sfapp action needs to be performed.",
"maxLength": 18,
"pattern": "^(([1-9][0-9]*))$",
"type": "string"
},
"sprm": {
"description": "This SCCP parameter is used to decide whether the SCCP NP, NAI and GTA shall be picked up from CDPA or CGPA for comparing.",
"enum": [
"Cggta",
"Cdgta"
],
"type": "string"
},
"ssn": {
"description": "The subsystem number in the SCCP called party address of the MSU.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"tt": {
"description": "New Translation Type.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"threshold": {
"description": "If the number of MSUs serviced by the SFTHROT action exceeds threshold value, MSUs are discarded.",
"maximum": 4294967295,
"minimum": 1,
"default": 1,
"type": "integer"
},
"taIndex": {
"description": "Throttle Action Index for Measurements",
"readOnly": true,
"type": "integer"
},
"tprm": {
"description": "This TCAP parameter is used to decide whether the MAP digits, NP and NoN shall be picked form SMRPDA or SMRPOA for comparison.",
"enum": [
"Smrpoa",
"Smrpda"
],
"type": "string"
},
"udtserr": {
"description": "The reason associated with the UDTS GTT Action for discarding the message.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"uimreqd": {
"description": "This specifies whether a UIM should be generated. When set to true, UIM is not generated.",
"default": false,
"type": "boolean"
},
"useicmsg": {
"description": "This specifies whether to apply GTT Action data to the message as the message was received (OFF).",
"type": "boolean"
},
"valType": {
"description": "This parameter is used to decide whether SCCP/TCAP parameter should be used for the validation of the MSU or IR21 data should be used for the validation of the MSU.",
"enum": [
"SccpToTcap",
"IR21ToTcap"
],
"default": "SccpToTcap",
"type": "string"
}
},
"required": [
"act",
"actid"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"act": "Fwd",
"actid": "actfwd1",
"cdGtmodName": "cdGtmod1",
"cgGtmodName": "cgGtmod1",
"loopSetName": "loopset1",
"mrnset": 10,
"ri": "Gt",
"rspName": "RSP1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/gttactions/{name}
Updates the configuration of the specified GTT Action. If the provided GTT Action data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttaction/gttaction.json",
"properties": {
"act": {
"description": "The action applied to the message.",
"enum": [
"Disc",
"Dup",
"Fwd",
"Scpval",
"Sfthrot",
"Tcaperr",
"Sfapp",
"Udts"
],
"type": "string"
},
"handlresp": {
"description": "Handle Response",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"atigtmodName": {
"description": "Calling party global title modification name for ATI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"psigtmodName": {
"description": "Calling party global title modification name for PSI. The GTMOD Name to be associated with the calling party of a SFAPP GTT Action entry.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"actid": {
"description": "This parameter specifies the Action ID associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"atcaperr": {
"description": "The reason for discarding the message containing the ANSI TCAP portion that is associated with the TCAP GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"cdGtmodName": {
"description": "This parameter specifies the CDPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgGtmodName": {
"description": "This parameter specifies the CGPA GtMod Name (/vstp/gtmods/) associated with the GTT action entry. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgpc": {
"description": "Ansi originating point code with subfields network indicator-network cluster-network cluster member (ni-nc-ncm). ITU international originating point code with subfields zone-area-id. The prefix subfield indicates a spare point code (prefix-zone-area-id). ITU originating point code in the format of a 5-digit number (nnnnn); or 2, 3, or 4 numbers (members). The prefix subfield indicates a spare point code (prefix-nnnnn, prefix-nnnnn-gc, prefix-m1-m2-m3-m4, prefix-m1-m2-m3-m4-gc). 24-bit ITU national originating point code with subfields main signaling area-sub signaling area-signaling point (msa-ssa-sp)",
"maxLength": 11,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"cgpcogmsg": {
"description": "The data that is used as the Calling Party Point Code in the outgoing message. Dflt - The standard Global Title Translation process supplies the CgPA PC. Cgpcicmsg - CgPA PC data from the incoming MSU. Opcicmsg - OPC data from the incoming MSU. Provcgpc - provisioned CGPC data in the GTT Action. Remove - CGPC will be removed from outgoing MSU.",
"enum": [
"Dflt",
"Cgpcicmsg",
"Opcicmsg",
"Provcgpc",
"Remove"
],
"default": "Dflt",
"type": "string"
},
"defactid": {
"description": "The default action that is performed when the fwd GTT Action fails to route the MSU. 1 leading alphabetic character followed by 8 alphanumeric characters. The defactid parameter can take one of the following values: 1)GTT Action ID with a GTT Action of disc, udts, or tcaperr. This value must already be defined in the GTT Action table. 2)fallback - The MSU is routed using routing data in the translated MSU when action is fwd.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"domain": {
"description": "This defines the type of CGPC domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"failactName": {
"description": "Fail Action Name. The default action that is performed to route the message when the VLR Validation fails on Stateful App.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "fallback",
"type": "string"
},
"fwdgttName": {
"description": "Forward GTT. The forward GTT Action Name that is to be used to route the MSU.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"hlraddr": {
"description": "This defines address of the HLR for the ATI message.",
"enum": [
"Usecdpa",
"Tcapparm",
"Fwdact"
],
"default": "Usecdpa",
"type": "string"
},
"itcaperr": {
"description": "The reason for discarding the message containing the ITU TCAP portion that is associated with the TCAPERR GTT Action.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"loopSetName": {
"description": "Name for the Loop set (/vstp/sccploopsets) associated with GTA, it must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "This parameter specifies the Mated Application Set ID.",
"maximum": 6000,
"minimum": 1,
"type": "integer"
},
"mrnSetId": {
"description": "The Mated Relay Node Set ID.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"ndgt": {
"description": "Number of digits to be matched. This parameter is used to specify the number of digits that needs to be matched between SCCP parameter and MAP parameter..",
"pattern": "^(([0]?[1-9])|([1][0-9])|2[0-1])$|^(All)$",
"default": "All",
"type": "string"
},
"ri": {
"description": "The routing indicator in the SCCP called party address of the duplicated copy of MSU.",
"enum": [
"Gt",
"Ssn"
],
"default": "Ssn",
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this Global Title Address (GTA).",
"maxLength": 18,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"scfaddr": {
"description": "Defines the GSM SCFAddressparameter must be specified when sfapp action needs to be performed.",
"maxLength": 18,
"pattern": "^(([1-9][0-9]*))$",
"type": "string"
},
"sprm": {
"description": "This SCCP parameter is used to decide whether the SCCP NP, NAI and GTA shall be picked up from CDPA or CGPA for comparing.",
"enum": [
"Cggta",
"Cdgta"
],
"type": "string"
},
"ssn": {
"description": "The subsystem number in the SCCP called party address of the MSU.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"tt": {
"description": "New Translation Type.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"threshold": {
"description": "If the number of MSUs serviced by the SFTHROT action exceeds threshold value, MSUs are discarded.",
"maximum": 4294967295,
"minimum": 1,
"default": 1,
"type": "integer"
},
"taIndex": {
"description": "Throttle Action Index for Measurements",
"readOnly": true,
"type": "integer"
},
"tprm": {
"description": "This TCAP parameter is used to decide whether the MAP digits, NP and NoN shall be picked form SMRPDA or SMRPOA for comparison.",
"enum": [
"Smrpoa",
"Smrpda"
],
"type": "string"
},
"udtserr": {
"description": "The reason associated with the UDTS GTT Action for discarding the message.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"uimreqd": {
"description": "This specifies whether a UIM should be generated. When set to true, UIM is not generated.",
"default": false,
"type": "boolean"
},
"useicmsg": {
"description": "This specifies whether to apply GTT Action data to the message as the message was received (OFF).",
"type": "boolean"
},
"valType": {
"description": "This parameter is used to decide whether SCCP/TCAP parameter should be used for the validation of the MSU or IR21 data should be used for the validation of the MSU.",
"enum": [
"SccpToTcap",
"IR21ToTcap"
],
"default": "SccpToTcap",
"type": "string"
}
},
"required": [
"act",
"actid"
],
"type": "object"
}
Example
{
"act": "Fwd",
"actid": "actfwd1",
"cdGtmodName": "cdGtmod1",
"cgGtmodName": "cgGtmod1",
"loopSetName": "loopset1",
"mrnset": 10,
"ri": "Gt",
"rspName": "RSP1"
}
delete /vstp/gttactions/{name}
Deletes the specified GTT Action from the SOAM configuration. An attempt to delete a GTT Action which does not exist results in an error message returned within the HTTP response. GTT Action cannot be removed if already used by GTT Action Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: GTT Modifications
A Global Title Translation (GTT) Modification is an entity assigned to a GTT set (/vstp/globaltitleaddresses) and GTT Actions (/vstp/gttactions).
All configuration of GTT Modification is done at the SOAM.
/vstp/gttmods
get /vstp/gttmods
Returns all GTT Modifications that meet the criteria specified in the GET request. By default, all GTT Modification configured at the SOAM are returned. If paging parameters are supplied, only those GTT Modifications meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/gttmodCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttmod/gttmod.json",
"properties": {
"cgpaSsn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"gtZeroFill": {
"description": "GT filler indicator in case of GTI change",
"type": "boolean",
"default": false
},
"gtmodId": {
"description": "Auto-generated Id for this SCCP GTT MOD",
"readOnly": true,
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this SCCP GTT MOD. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"newGTI": {
"description": "Defines the new Global Title Indicator for this GTT Mod. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"newNAI": {
"description": "Defines new Nature of Address indicator for this GTT Mod. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"newNP": {
"description": "Defines new Numbering plan (NP) for this GTT Mod. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"newTT": {
"description": "Defines the new translation type (TT) for this GTT Mod.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted from the prefix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The digits to be prefixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. The number of digits to be deleted from the suffix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The digits to be suffixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sfxFirst": {
"description": "Suffix Prefix processing Precedence indicator.",
"type": "boolean",
"default": false
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"cgpaSsn": 100,
"gtZeroFill": false,
"name": "gttMod1",
"newGTI": "TtNumEncodingNature",
"newNAI": 45,
"newNP": 9,
"newTT": 2,
"npdd": 3,
"npds": "567",
"nsdd": 2,
"nsds": "64",
"sfxFirst": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/gttmods
Adds a new GTT Modification to the VSTP configuration. The GTT Modification name must be unique as it refers to the GTA and GTT Actions at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttmod/gttmod.json",
"properties": {
"cgpaSsn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"gtZeroFill": {
"description": "GT filler indicator in case of GTI change",
"type": "boolean",
"default": false
},
"gtmodId": {
"description": "Auto-generated Id for this SCCP GTT MOD",
"readOnly": true,
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this SCCP GTT MOD. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"newGTI": {
"description": "Defines the new Global Title Indicator for this GTT Mod. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"newNAI": {
"description": "Defines new Nature of Address indicator for this GTT Mod. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"newNP": {
"description": "Defines new Numbering plan (NP) for this GTT Mod. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"newTT": {
"description": "Defines the new translation type (TT) for this GTT Mod.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted from the prefix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The digits to be prefixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. The number of digits to be deleted from the suffix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The digits to be suffixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sfxFirst": {
"description": "Suffix Prefix processing Precedence indicator.",
"type": "boolean",
"default": false
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"cgpaSsn": 100,
"gtZeroFill": false,
"name": "gttMod1",
"newGTI": "TtNumEncodingNature",
"newNAI": 45,
"newNP": 9,
"newTT": 2,
"npdd": 3,
"npds": "567",
"nsdd": 2,
"nsds": "64",
"sfxFirst": true
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/gttmods/{name}
get /vstp/gttmods/{name}
Returns the configuration details for the specified GTT Modification. If the GTT does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/gttmodItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttmod/gttmod.json",
"properties": {
"cgpaSsn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"gtZeroFill": {
"description": "GT filler indicator in case of GTI change",
"type": "boolean",
"default": false
},
"gtmodId": {
"description": "Auto-generated Id for this SCCP GTT MOD",
"readOnly": true,
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this SCCP GTT MOD. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"newGTI": {
"description": "Defines the new Global Title Indicator for this GTT Mod. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"newNAI": {
"description": "Defines new Nature of Address indicator for this GTT Mod. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"newNP": {
"description": "Defines new Numbering plan (NP) for this GTT Mod. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"newTT": {
"description": "Defines the new translation type (TT) for this GTT Mod.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted from the prefix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The digits to be prefixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. The number of digits to be deleted from the suffix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The digits to be suffixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sfxFirst": {
"description": "Suffix Prefix processing Precedence indicator.",
"type": "boolean",
"default": false
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"cgpaSsn": 100,
"gtZeroFill": false,
"name": "gttMod1",
"newGTI": "TtNumEncodingNature",
"newNAI": 45,
"newNP": 9,
"newTT": 2,
"npdd": 3,
"npds": "567",
"nsdd": 2,
"nsds": "64",
"sfxFirst": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/gttmods/{name}
Updates the configuration of the specified GTT Modification. If the provided GTT Modification data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttmod/gttmod.json",
"properties": {
"cgpaSsn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"gtZeroFill": {
"description": "GT filler indicator in case of GTI change",
"type": "boolean",
"default": false
},
"gtmodId": {
"description": "Auto-generated Id for this SCCP GTT MOD",
"readOnly": true,
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"name": {
"description": "Name for this SCCP GTT MOD. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"newGTI": {
"description": "Defines the new Global Title Indicator for this GTT Mod. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"newNAI": {
"description": "Defines new Nature of Address indicator for this GTT Mod. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"newNP": {
"description": "Defines new Numbering plan (NP) for this GTT Mod. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"newTT": {
"description": "Defines the new translation type (TT) for this GTT Mod.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"npdd": {
"description": "Number of prefix digits to be deleted. The number of digits to be deleted from the prefix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"npds": {
"description": "New prefix digits string. The digits to be prefixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"nsdd": {
"description": "Number of suffix digits to be deleted. The number of digits to be deleted from the suffix of the received GT address.",
"maximum": 21,
"minimum": 1,
"type": "integer"
},
"nsds": {
"description": "New suffix digits string. The digits to be suffixed to the received GT address.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sfxFirst": {
"description": "Suffix Prefix processing Precedence indicator.",
"type": "boolean",
"default": false
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"cgpaSsn": 100,
"gtZeroFill": false,
"name": "gttMod1",
"newGTI": "TtNumEncodingNature",
"newNAI": 45,
"newNP": 9,
"newTT": 2,
"npdd": 3,
"npds": "567",
"nsdd": 2,
"nsds": "64",
"sfxFirst": true
}
delete /vstp/gttmods/{name}
Deletes the specified GTT Modification from the SOAM configuration. A GTT Modification can only be deleted if all delete validation checks pass. In general, if the GTT Modification is associated with a GTT Set (/vstp/gttsets), the GTT Modification cannot be deleted. An attempt to delete a GTT Modification that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: GTT Selectors
A Global Title Translation (GTT) Selector is an entity assigned to a GTT set (/vstp/gttsets).
All configuration of GTT Selector is done at the SOAM.
/vstp/gttselectors
get /vstp/gttselectors
Returns all GTT Selectors that meet the criteria specified in the GET request. By default, all GTT Selector configured at the SOAM are returned. If paging parameters are supplied, only those GTT Selectors meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=GttSel1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/gttselectorCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttselector/gttselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cdgttsn": {
"description": "CdPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cggttsn": {
"description": "CgPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgssn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"globalTitleIndicator": {
"description": "Defines the domain for this GTT Selector. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"NoGlobal",
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"gttSetName": {
"description": "Name of the SCCP GTT Set (/vstp/gttsets) associated with this GTT Selector.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"linksetName": {
"description": "Linkset name (/vstp/linksets) associated with this GTT Selector.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this SCCP GTT Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"selid": {
"description": "Selector ID.",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"translationType": {
"description": "Defines the translation type (TT) for this GTT Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "0",
"domain": "Itui",
"globalTitleIndicator": "TtNumEncodingNature",
"gttSetName": "GTTSET1",
"name": "GttSel1",
"natureOfAddressIndicatorValue": 4,
"numberingPlanValue": 3,
"translationType": 2
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/gttselectors
Adds a new GTT Selector to the VSTP configuration. The GTT Selector name must be unique as it refers to the GTT Set name at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttselector/gttselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cdgttsn": {
"description": "CdPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cggttsn": {
"description": "CgPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgssn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"globalTitleIndicator": {
"description": "Defines the domain for this GTT Selector. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"NoGlobal",
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"gttSetName": {
"description": "Name of the SCCP GTT Set (/vstp/gttsets) associated with this GTT Selector.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"linksetName": {
"description": "Linkset name (/vstp/linksets) associated with this GTT Selector.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this SCCP GTT Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"selid": {
"description": "Selector ID.",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"translationType": {
"description": "Defines the translation type (TT) for this GTT Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"domain": "Itui",
"globalTitleIndicator": "TtNumEncodingNature",
"gttSetName": "GTTSET1",
"name": "GttSel1",
"natureOfAddressIndicatorValue": 4,
"numberingPlanValue": 3,
"translationType": 2
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/gttselectors/{name}
get /vstp/gttselectors/{name}
Returns the configuration details for the specified GTT Selector. If the GTT does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/gttselectorItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttselector/gttselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cdgttsn": {
"description": "CdPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cggttsn": {
"description": "CgPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgssn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"globalTitleIndicator": {
"description": "Defines the domain for this GTT Selector. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"NoGlobal",
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"gttSetName": {
"description": "Name of the SCCP GTT Set (/vstp/gttsets) associated with this GTT Selector.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"linksetName": {
"description": "Linkset name (/vstp/linksets) associated with this GTT Selector.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this SCCP GTT Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"selid": {
"description": "Selector ID.",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"translationType": {
"description": "Defines the translation type (TT) for this GTT Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"domain": "Itui",
"globalTitleIndicator": "TtNumEncodingNature",
"gttSetName": "GTTSET1",
"name": "GttSel1",
"natureOfAddressIndicatorValue": 4,
"numberingPlanValue": 3,
"translationType": 2
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/gttselectors/{name}
Updates the configuration of the specified GTT Selector. If the provided GTT Selector data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttselector/gttselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cdgttsn": {
"description": "CdPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cggttsn": {
"description": "CgPA GTT set name (/vstp/gttsets) associated with this GTT Selector. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"cgssn": {
"description": "CgPA subsystem number.",
"maximum": 255,
"minimum": 0,
"type": "integer"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"globalTitleIndicator": {
"description": "Defines the domain for this GTT Selector. When set to NoGlobal, then 0 value is assigned corresponding to the domain that is set. When set to TtNumEncodingNature, then 4 value is assigned corresponding to the itu domain set. When set to TtOnly, then 2 value is assigned corresponding to the domain that is set. Only one entry for NoGlobal can be set corresponding to each domain and multiple entries can exist for TtOnly corresponding to each domain.",
"enum": [
"NoGlobal",
"TtNumEncodingNature",
"TtOnly"
],
"type": "string"
},
"gttSetName": {
"description": "Name of the SCCP GTT Set (/vstp/gttsets) associated with this GTT Selector.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"linksetName": {
"description": "Linkset name (/vstp/linksets) associated with this GTT Selector.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this SCCP GTT Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"selid": {
"description": "Selector ID.",
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"translationType": {
"description": "Defines the translation type (TT) for this GTT Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"domain": "Itui",
"globalTitleIndicator": "TtNumEncodingNature",
"gttSetName": "GTTSET1",
"name": "GttSel1",
"natureOfAddressIndicatorValue": 4,
"numberingPlanValue": 3,
"translationType": 2
}
delete /vstp/gttselectors/{name}
Deletes the specified GTT Selector from the SOAM configuration. A GTT Selector can only be deleted if all delete validation checks pass. In general, if the GTT Selector is associated with a GTT Set (/vstp/gttsets), the GTT Selector cannot be deleted. An attempt to delete a GTT Selector that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: GTT Sets
A GTT Set is a an entity to which Global Title Addresses (/vstp/globaltitleaddresses) and Selectors (/vstp/gttselectors) are assigned.
All configuration of GTT Sets is done at the SOAM.
/vstp/gttsets
get /vstp/gttsets
Returns all GTT Sets that meet the criteria specified in the GET request. By default, all GTT Sets configured at the SOAM are returned. If paging parameters are supplied, only those GTT Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/gttsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttset/gttset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain. This GTTSET MO does not distinguish between ITU national or ITU international.",
"enum": [
"Ansi",
"Cross",
"Itu"
],
"type": "string"
},
"gttSetType": {
"description": "Defines the type of GTT Set.",
"default": "Cdgta",
"enum": [
"Cdgta",
"Cdssn",
"Cggta",
"Cgpc",
"Cgssn",
"Imsi",
"Msisdn",
"Opc",
"Opcode",
"Vlrnb",
"Smrpoa",
"Smrpda",
"Dpc"
],
"type": "string"
},
"name": {
"description": "Name for the SCCP GTT Set, which must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"checkmulcomp": {
"description": "Check Multiple Components. This parameter specifies whether to support TCAP multicomponent packets.",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"npsn": {
"description": "GTT set name (Not Present Set Name). This parameter can have Imsi/Msisdn/Vlrnb/Smrpoa/Smrpda GTT set types. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
}
},
"required": [
"domain",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "1",
"domain": "Ansi",
"gttSetType": "Cdgta",
"name": "gttset1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/gttsets
Adds a new GTT Set to the VSTP configuration. The GTT Set name must be unique across all GTT Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttset/gttset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain. This GTTSET MO does not distinguish between ITU national or ITU international.",
"enum": [
"Ansi",
"Cross",
"Itu"
],
"type": "string"
},
"gttSetType": {
"description": "Defines the type of GTT Set.",
"default": "Cdgta",
"enum": [
"Cdgta",
"Cdssn",
"Cggta",
"Cgpc",
"Cgssn",
"Imsi",
"Msisdn",
"Opc",
"Opcode",
"Vlrnb",
"Smrpoa",
"Smrpda",
"Dpc"
],
"type": "string"
},
"name": {
"description": "Name for the SCCP GTT Set, which must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"checkmulcomp": {
"description": "Check Multiple Components. This parameter specifies whether to support TCAP multicomponent packets.",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"npsn": {
"description": "GTT set name (Not Present Set Name). This parameter can have Imsi/Msisdn/Vlrnb/Smrpoa/Smrpda GTT set types. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
}
},
"required": [
"domain",
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"domain": "Ansi",
"gttSetType": "Cdgta",
"name": "gttset1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/gttsets/{name}
get /vstp/gttsets/{name}
Returns the configuration details for the specified GTT Set. If the GTT Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/gttsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttset/gttset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain. This GTTSET MO does not distinguish between ITU national or ITU international.",
"enum": [
"Ansi",
"Cross",
"Itu"
],
"type": "string"
},
"gttSetType": {
"description": "Defines the type of GTT Set.",
"default": "Cdgta",
"enum": [
"Cdgta",
"Cdssn",
"Cggta",
"Cgpc",
"Cgssn",
"Imsi",
"Msisdn",
"Opc",
"Opcode",
"Vlrnb",
"Smrpoa",
"Smrpda",
"Dpc"
],
"type": "string"
},
"name": {
"description": "Name for the SCCP GTT Set, which must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"checkmulcomp": {
"description": "Check Multiple Components. This parameter specifies whether to support TCAP multicomponent packets.",
"enum": [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"npsn": {
"description": "GTT set name (Not Present Set Name). This parameter can have Imsi/Msisdn/Vlrnb/Smrpoa/Smrpda GTT set types. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
}
},
"required": [
"domain",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "1",
"domain": "Ansi",
"gttSetType": "Cdgta",
"name": "gttset1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/gttsets/{name}
delete /vstp/gttsets/{name}
Deletes the specified GTT Set from the SOAM configuration. A GTT Set can only be deleted if all delete validation checks pass. If the GTT Set is part of the configuration of one or more GTT Selector (/vstp/gttselector) or Global Title Address (/vstp/globaltitleaddresses) instances, the GTT Set must first be removed from the GTT Selector (/vstp/gttselector) and Global Title Address (/vstp/globaltitleaddresses). An attempt to delete a GTT Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: GTT Action Sets
A GTT Action Set consists of an Action Set name and a group of actions. The specified actions determine what actions are applied to the MSU during translation.
All configuration of GTT Action Sets is done at the SOAM.
/vstp/gttactionsets
get /vstp/gttactionsets
Returns all GTT Action Sets that meet the criteria specified in the GET request. By default, all GTT Action Sets configured at the SOAM are returned. If paging parameters are supplied, only those GTT Action Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/gttactionsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttactionset/gttactionset.json",
"properties": {
"actsn": {
"description": "GTT Action Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid1": {
"description": "GTT Action ID 1 (/vstp/gttactions). The first action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid2": {
"description": "GTT Action ID 2 (/vstp/gttactions). The second action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid3": {
"description": "GTT Action ID 3 (/vstp/gttactions). The third action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"testMode": {
"description": "If testMode parameter is off, GTT ACTION SET will follow the existing behavior i.e. actions will be executed on the MSU and event will be generated. If testMode parameter is on, GTT ACTION SET will only generate event about the actions and will actually not execute any action on MSU.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
}
},
"required": [
"actsn"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"actsn": "actset1",
"actid1": "throt1",
"actid2": "dup1",
"actid3": "disc1",
"testMode": "Off"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/gttactionsets
Adds a new GTT Action Set to the VSTP configuration. The GTT Action Set name must be unique across all GTT Action Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttactionset/gttactionset.json",
"properties": {
"actsn": {
"description": "GTT Action Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid1": {
"description": "GTT Action ID 1 (/vstp/gttactions). The first action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid2": {
"description": "GTT Action ID 2 (/vstp/gttactions). The second action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid3": {
"description": "GTT Action ID 3 (/vstp/gttactions). The third action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"testMode": {
"description": "If testMode parameter is off, GTT ACTION SET will follow the existing behavior i.e. actions will be executed on the MSU and event will be generated. If testMode parameter is on, GTT ACTION SET will only generate event about the actions and will actually not execute any action on MSU.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
}
},
"required": [
"actsn"
],
"type": "object"
}
Example
{
"actsn": "actset1",
"actid1": "throt1",
"actid2": "dup1",
"actid3": "disc1",
"testMode": "Off"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/gttactionsets/{name}
get /vstp/gttactionsets/{name}
Returns the configuration details for the specified GTT Action Set. If the GTT Action Set does not exist in the SOAM configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/gttactionsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttactionset/gttactionset.json",
"properties": {
"actsn": {
"description": "GTT Action Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid1": {
"description": "GTT Action ID 1 (/vstp/gttactions). The first action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid2": {
"description": "GTT Action ID 2 (/vstp/gttactions). The second action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid3": {
"description": "GTT Action ID 3 (/vstp/gttactions). The third action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"testMode": {
"description": "If testMode parameter is off, GTT ACTION SET will follow the existing behavior i.e. actions will be executed on the MSU and event will be generated. If testMode parameter is on, GTT ACTION SET will only generate event about the actions and will actually not execute any action on MSU.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
}
},
"required": [
"actsn"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"actsn": "actset1",
"actid1": "throt1",
"actid2": "dup1",
"actid3": "disc1",
"testMode": "Off"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/gttactionsets/{name}
Updates the configuration of the specified GTT Action Set. If the provided GTT Action Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/gttactionset/gttactionset.json",
"properties": {
"actsn": {
"description": "GTT Action Set Name. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid1": {
"description": "GTT Action ID 1 (/vstp/gttactions). The first action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid2": {
"description": "GTT Action ID 2 (/vstp/gttactions). The second action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"actid3": {
"description": "GTT Action ID 3 (/vstp/gttactions). The third action ID associated with the GTT action set. 1 leading alphabetic character and up to 8 following alphanumeric characters.",
"maxLength": 9,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"testMode": {
"description": "If testMode parameter is off, GTT ACTION SET will follow the existing behavior i.e. actions will be executed on the MSU and event will be generated. If testMode parameter is on, GTT ACTION SET will only generate event about the actions and will actually not execute any action on MSU.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
}
},
"required": [
"actsn"
],
"type": "object"
}
Example
{
"actsn": "actset1",
"actid1": "throt1",
"actid2": "dup1",
"actid3": "disc1",
"testMode": "Off"
}
delete /vstp/gttactionsets/{name}
Deletes the specified GTT Action Set from the SOAM configuration. A GTT Action Set can only be deleted if all delete validation checks pass. If the GTT Action Set is part of the configuration of one or more Global Title Address (/vstp/globaltitleaddresses) instances, the GTT Action Set must first be removed from the Global Title Address (/vstp/globaltitleaddresses). An attempt to delete a GTT Action Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Interface Mappings
An Interface Mapping is a mapping between MTP2 and PCI interfaces.
All configuration of Interface Mapping is done at the SOAM.
/vstp/interfacemappings
get /vstp/interfacemappings
Returns all Interface Mappings that meet the criteria specified in the GET request. By default, all Interface Mappings configured at the SOAM are returned. If paging parameters are supplied, only those Interface Mappings meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/interfacemappingCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/interfacemapping/interfacemapping.json",
"properties": {
"channelName": {
"description": "This is the name assigned to interface mapping. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"linkType": {
"description": "This defines the types of links which are added in VSTP.",
"enum": [
"T1",
"E1",
"E1_hsl",
"T1_hsl"
],
"type": "string"
},
"port": {
"description": "The defines the value of port assigned to interface mappping.",
"maximum": 7,
"minimum": 0,
"type": "integer"
},
"timeSlot": {
"description": "This defines the time slot. Zero is not allowed value.",
"maximum": 31,
"minimum": 1,
"type": "integer"
},
"hostName": {
"description": "The hostName is the name of the server associated with the interface mapping. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and hyphen. The name must start with one alphanumeric and must not start with a hyphen.",
"maxLength": 40,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"type": "string"
},
"sequenceLength": {
"description": "This defines the sequence bit length of the link.",
"enum": [
"7_BIT",
"10_BIT",
"12_BIT"
],
"type": "string"
},
"boardType": {
"description": "This defines the Type of Board.",
"enum": [
"MTP2_BOARD_TYPE_ELYNX",
"MTP2_BOARD_TYPE_ADAX"
],
"default": "MTP2_BOARD_TYPE_ELYNX",
"type": "string"
},
"encodingScheme": {
"description": "Indicator for use of B8ZS, HDB3 or AMI encoding/decoding.",
"enum": [
"ENCODE_NONE",
"ENCODE_B8ZS",
"ENCODE_AMI",
"ENCODE_HDB3"
],
"type": "string"
},
"minSuRate": {
"description": "Minimum signal unit rate. The minimum number of SUs present on a link uniformly distributed. ",
"maximum": 2000,
"minimum": 400,
"default": 1000,
"type": "integer"
},
"si": {
"description": "Value of two Spare International bits of NFAS data. ",
"maximum": 3,
"minimum": 0,
"default": 0,
"type": "integer"
},
"sn": {
"description": "Value of five Spare International bits of NFAS data.",
"maximum": 31,
"minimum": 0,
"default": 0,
"type": "integer"
},
"framing": {
"description": "Indicator for framing format..",
"enum": [
"FRAMING_NONE",
"FRAMING_SF",
"FRAMING_ESF"
],
"default": "FRAMING_SF",
"type": "string"
},
"crcOn": {
"description": "This defines if crc should be enabled or disabled.",
"enum": [
"No",
"Yes"
],
"default": "Yes",
"type": "string"
},
"ll": {
"description": "T1 cable length in feet between the nodes",
"maximum": 655,
"minimum": 0,
"default": 133,
"type": "integer"
},
"ecm": {
"description": "Error Correction Method. ",
"enum": [
"LINK_ECM_BASIC",
"LINK_ECM_PCR"
],
"default": "LINK_ECM_BASIC",
"type": "string"
},
"pcrn1": {
"description": "Threshold of the number of MSUs available for retransmission. If the error correction method being used is PCR and this threshold is reached, no new MSUs or FISUs are sent. The retransmission cycle is continued up to the last MSU entered into the retransmission buffer in the order in which they were originally transmitted. ",
"maximum": 1023,
"minimum": 1,
"type": "integer"
},
"pcrn2": {
"description": "Threshold of the number of MSU octets available for retransmission. If the error correction method being used is PCR, and this threshold is reached, no new MSUs or FISUs are sent. The retransmission cycle is continued up to the last MSU entered into the retransmission buffer in the order in which they were originally transmitted. ",
"maximum": 287744,
"minimum": 300,
"type": "integer"
},
"speed": {
"description": "This defines the type of speed enums and their corresponding values.",
"enum": [
"Lsl_56k",
"Lsl_64k",
"Hsl_2048k",
"Hsl_1536k"
],
"default": "Lsl_56k",
"type": "string"
}
},
"required": [
"channelName",
"linkType",
"port",
"hostName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"channelName": "Interface1",
"hostName": "MP1",
"linkType": "T1",
"port": 3,
"sequenceLength": "7_BIT",
"speed": "LSL_56K",
"timeSlot": 20
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/interfacemappings
Adds a new Interface Mapping to the VSTP configuration. The Interface Mapping name must be unique across all Interface Mappings at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/interfacemapping/interfacemapping.json",
"properties": {
"channelName": {
"description": "This is the name assigned to interface mapping. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"linkType": {
"description": "This defines the types of links which are added in VSTP.",
"enum": [
"T1",
"E1",
"E1_hsl",
"T1_hsl"
],
"type": "string"
},
"port": {
"description": "The defines the value of port assigned to interface mappping.",
"maximum": 7,
"minimum": 0,
"type": "integer"
},
"timeSlot": {
"description": "This defines the time slot. Zero is not allowed value.",
"maximum": 31,
"minimum": 1,
"type": "integer"
},
"hostName": {
"description": "The hostName is the name of the server associated with the interface mapping. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and hyphen. The name must start with one alphanumeric and must not start with a hyphen.",
"maxLength": 40,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"type": "string"
},
"sequenceLength": {
"description": "This defines the sequence bit length of the link.",
"enum": [
"7_BIT",
"10_BIT",
"12_BIT"
],
"type": "string"
},
"boardType": {
"description": "This defines the Type of Board.",
"enum": [
"MTP2_BOARD_TYPE_ELYNX",
"MTP2_BOARD_TYPE_ADAX"
],
"default": "MTP2_BOARD_TYPE_ELYNX",
"type": "string"
},
"encodingScheme": {
"description": "Indicator for use of B8ZS, HDB3 or AMI encoding/decoding.",
"enum": [
"ENCODE_NONE",
"ENCODE_B8ZS",
"ENCODE_AMI",
"ENCODE_HDB3"
],
"type": "string"
},
"minSuRate": {
"description": "Minimum signal unit rate. The minimum number of SUs present on a link uniformly distributed. ",
"maximum": 2000,
"minimum": 400,
"default": 1000,
"type": "integer"
},
"si": {
"description": "Value of two Spare International bits of NFAS data. ",
"maximum": 3,
"minimum": 0,
"default": 0,
"type": "integer"
},
"sn": {
"description": "Value of five Spare International bits of NFAS data.",
"maximum": 31,
"minimum": 0,
"default": 0,
"type": "integer"
},
"framing": {
"description": "Indicator for framing format..",
"enum": [
"FRAMING_NONE",
"FRAMING_SF",
"FRAMING_ESF"
],
"default": "FRAMING_SF",
"type": "string"
},
"crcOn": {
"description": "This defines if crc should be enabled or disabled.",
"enum": [
"No",
"Yes"
],
"default": "Yes",
"type": "string"
},
"ll": {
"description": "T1 cable length in feet between the nodes",
"maximum": 655,
"minimum": 0,
"default": 133,
"type": "integer"
},
"ecm": {
"description": "Error Correction Method. ",
"enum": [
"LINK_ECM_BASIC",
"LINK_ECM_PCR"
],
"default": "LINK_ECM_BASIC",
"type": "string"
},
"pcrn1": {
"description": "Threshold of the number of MSUs available for retransmission. If the error correction method being used is PCR and this threshold is reached, no new MSUs or FISUs are sent. The retransmission cycle is continued up to the last MSU entered into the retransmission buffer in the order in which they were originally transmitted. ",
"maximum": 1023,
"minimum": 1,
"type": "integer"
},
"pcrn2": {
"description": "Threshold of the number of MSU octets available for retransmission. If the error correction method being used is PCR, and this threshold is reached, no new MSUs or FISUs are sent. The retransmission cycle is continued up to the last MSU entered into the retransmission buffer in the order in which they were originally transmitted. ",
"maximum": 287744,
"minimum": 300,
"type": "integer"
},
"speed": {
"description": "This defines the type of speed enums and their corresponding values.",
"enum": [
"Lsl_56k",
"Lsl_64k",
"Hsl_2048k",
"Hsl_1536k"
],
"default": "Lsl_56k",
"type": "string"
}
},
"required": [
"channelName",
"linkType",
"port",
"hostName"
],
"type": "object"
}
Example
{
"channelName": "Interface1",
"hostName": "MP1",
"linkType": "T1",
"port": 3,
"sequenceLength": "7_BIT",
"speed": "LSL_56K",
"timeSlot": 20
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
delete /vstp/interfacemappings
Deletes the specified Interface Mapping from the SOAM configuration. A Interface Mapping can only be deleted if all delete validation checks pass. An attempt to delete a Interface Mapping that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Vstp: HomeEntity
A Home Entity (/vstp/homeentities) is added for two different types 'HomeRN'and 'HomeSMSC'.
All configuration of Home Entity Modification is done at the SOAM.
/vstp/homeentities
get /vstp/homeentities
Returns all Home Entities that meet the criteria specified in the GET request. By default, all Home Entities configured at the SOAM are returned. If paging parameters are supplied, only those Home Entities the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/homeentityCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/homeentity/homeentity.json",
"properties": {
"entityAddress": {
"description": "Entity Address prefix digit string.Max length of HomeRn ,CdpnPfx and DialPfx entityType is 15 & Max length of HomeSmsc entityType is 21.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"entityType": {
"description": "This defines the type of entity.",
"enum": [
"HomeRn",
"HomeSmsc",
"CdpnPfx",
"DialPfx"
],
"type": "string"
},
"inpDelPfx": {
"description": "Delete prefix. This parameter specifies whether to delete the CdpnPfx.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Home Entity. Valid names are strings between one and 12 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 12,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"entityAddress",
"entityType",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"entityType": "HomeRn",
"entityAddress": "C441234",
"name": "homeEnt1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/homeentities
Adds a new Home Entity to the VSTP configuration. The Home Entity must be unique at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/homeentity/homeentity.json",
"properties": {
"entityAddress": {
"description": "Entity Address prefix digit string.Max length of HomeRn ,CdpnPfx and DialPfx entityType is 15 & Max length of HomeSmsc entityType is 21.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"entityType": {
"description": "This defines the type of entity.",
"enum": [
"HomeRn",
"HomeSmsc",
"CdpnPfx",
"DialPfx"
],
"type": "string"
},
"inpDelPfx": {
"description": "Delete prefix. This parameter specifies whether to delete the CdpnPfx.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Home Entity. Valid names are strings between one and 12 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 12,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"entityAddress",
"entityType",
"name"
],
"type": "object"
}
Example
{
"entityType": "HomeRn",
"entityAddress": "C441234",
"name": "homeEnt1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/homeentities/{name}
get /vstp/homeentities/{name}
Returns the configuration details for the specified Home Entity. If the Home Entity does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/homeentityItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/homeentity/homeentity.json",
"properties": {
"entityAddress": {
"description": "Entity Address prefix digit string.Max length of HomeRn ,CdpnPfx and DialPfx entityType is 15 & Max length of HomeSmsc entityType is 21.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"entityType": {
"description": "This defines the type of entity.",
"enum": [
"HomeRn",
"HomeSmsc",
"CdpnPfx",
"DialPfx"
],
"type": "string"
},
"inpDelPfx": {
"description": "Delete prefix. This parameter specifies whether to delete the CdpnPfx.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Home Entity. Valid names are strings between one and 12 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 12,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"entityAddress",
"entityType",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"entityType": "HomeRn",
"entityAddress": "C441234",
"name": "homeEnt1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/homeentities/{name}
Updates the configuration of the specified Home Entity. If the provided Home Entity data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response. Delete Prefix is an updateable attribute.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/homeentity/homeentity.json",
"properties": {
"entityAddress": {
"description": "Entity Address prefix digit string.Max length of HomeRn ,CdpnPfx and DialPfx entityType is 15 & Max length of HomeSmsc entityType is 21.",
"maxLength": 21,
"pattern": "^((0x|0X)?[a-fA-F0-9]*)$",
"type": "string"
},
"entityType": {
"description": "This defines the type of entity.",
"enum": [
"HomeRn",
"HomeSmsc",
"CdpnPfx",
"DialPfx"
],
"type": "string"
},
"inpDelPfx": {
"description": "Delete prefix. This parameter specifies whether to delete the CdpnPfx.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Home Entity. Valid names are strings between one and 12 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 12,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"entityAddress",
"entityType",
"name"
],
"type": "object"
}
Example
{
"entityType": "HomeRn",
"entityAddress": "C441234",
"name": "homeEnt1"
}
delete /vstp/homeentities/{name}
Deletes the specified Home Entity from the SOAM configuration. A Home Entity can only be deleted if all delete validation checks pass. An attempt to delete a Home Entity that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: IDPR Options
The Initial Detection Point Relay (IDPR) Options are those configuration values that govern the overall IDPR SMS. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new IDPR Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All IDPR Options configuration is done at the SOAM.
/vstp/idproptions
get /vstp/idproptions
Returns the set of current values for the IDPR Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/idproptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/idproption/idproption.json",
"properties": {
"cdcnp": {
"description": "Specifies whether the CutAndPaste parameter is included in the CONNECT message generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"cddnnotfndrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the Called Party Number (CdPN) is not found in the RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Release",
"type": "string"
},
"cddra": {
"description": "The destination routing address (DRA) used in the CONNECT message generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"Rn",
"Rndn",
"Grn",
"Rnasd",
"Asdrn",
"Rngrn",
"Grnrn",
"Ccrndn",
"Rnasddn",
"Asdrndn",
"Ccrnasddn",
"Ccasdrndn",
"Asdrnccdn",
"Rnasdccdn",
"Rngrndn",
"Grnrndn",
"Ccrngrndn",
"Ccgrnrndn",
"Grnrnccdn",
"Rngrnccdn",
"Grndn",
"Ccgrndn"
],
"default": "Rndn",
"type": "string"
},
"cddranai": {
"description": "The DRA nature of address indicator used in the CONNECT response generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"Sub",
"Unknown",
"Natl",
"Intl",
"Ntwk"
],
"default": "Natl",
"type": "string"
},
"cddranp": {
"description": "The DRA numbering plan used in the CONNECT response generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"E164",
"X121",
"F69"
],
"default": "E164",
"type": "string"
},
"cdnoentityrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when neither the RN nor SP entity is found in the CdPN RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Continue",
"type": "string"
},
"cdrelcause": {
"description": "The cause parameter value for the RELEASECALL message generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"maximum": 127,
"minimum": 1,
"default": 31,
"type": "integer"
},
"cdrnrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the CdPN is associated with an RN entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Connect",
"type": "string"
},
"cdsprsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the CdPN is associated with an SP entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Relay",
"type": "string"
},
"cgcnp": {
"description": "Specifies whether the CutAndPaste parameter is included in the CONNECT message generated by the INPRTG Service Action based on the CgPN RTDB lookup.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"cgdnnotfndrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the Calling Party Number (CgPN) is not found in the RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Release",
"type": "string"
},
"cgdra": {
"description": "The DRA used in the CONNECT response generated by the INPRTG Service Action based on the CGPN RTDB lookup.",
"enum" : [
"Rn",
"Rndn",
"Grn",
"Rnasd",
"Asdrn",
"Rngrn",
"Grnrn",
"Ccrndn",
"Rnasddn",
"Asdrndn",
"Ccrnasddn",
"Ccasdrndn",
"Asdrnccdn",
"Rnasdccdn",
"Rngrndn",
"Grnrndn",
"Ccrngrndn",
"Ccgrnrndn",
"Grnrnccdn",
"Rngrnccdn",
"Grndn",
"Ccgrndn"
],
"default": "Rndn",
"type": "string"
},
"cgdranai": {
"description": "The NAI option used in the CONNECT response generated by the INPRTG Service Action based on the CgPN lookup.",
"enum" : [
"Sub",
"Unknown",
"Natl",
"Intl",
"Ntwk"
],
"default": "Natl",
"type": "string"
},
"cgdranp": {
"description": "The DRA NP used in the CONNECT response generated by the INPRTG Service Action based on the CgPN lookup.",
"enum" : [
"E164",
"X121",
"F69"
],
"default": "E164",
"type": "string"
},
"cgnoentityrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when neither the RN nor SP entity is found in the CgPN RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Continue",
"type": "string"
},
"cgnptype": {
"description": "CgPN database lookup type. The entity type that is considered a success when used for RTDB lookup.",
"enum" : [
"Sp",
"Rn",
"Rnsp",
"Anymatch",
"Always",
"Rnspdn"
],
"default": "Rnsp",
"type": "string"
},
"cgpaccck": {
"description": "CgPA country code check. This parameter specifies whether a DEFCC check is performed on the incoming CgPA.",
"enum" : [
"Always",
"Nonintl",
"Off"
],
"default": "Nonintl",
"type": "string"
},
"cgpnskrtg": {
"description": "This parameter specifies whether SK routing occurs if IDP A-Party routing fails.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"cgrelcause": {
"description": "The cause parameter value in the RELEASECALL message generated by an INPRTG Service Action based on the CgPN RTDB lookup.",
"maximum": 127,
"minimum": 1,
"default": 31,
"type": "integer"
},
"cgrnrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the CgPN is associated with an RN entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Connect",
"type": "string"
},
"cgsnai": {
"description": "Calling party number nature of address indicator. The CgPN NAI that is used during number conditioning.",
"enum" : [
"Incoming",
"Intl",
"Natl",
"Unkn"
],
"default": "Incoming",
"type": "string"
},
"cgsprsp": {
"description": "The system response sent for an IDP message processed by the IDPR/TTR service when the CgPN is associated with an SP entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Relay",
"type": "string"
},
"dfltrn": {
"description": "Default routing number. The default RN used when a value of sp or rnsp is specified for the nptype parameter, and the CdPN RTDB lookup returns entity type SP.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlma": {
"description": "Delimiter A. The first delimiter used to format the outgoing TCAP DN.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmb": {
"description": "Delimiter B. The second delimiter used to format the outgoing TCAP DN.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmc": {
"description": "Delimiter C. The third delimiter used to format the outgoing TCAP DN.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"drafrmt": {
"description": "DRA digit format. The format of the DRA digits.",
"enum" : [
"Grn",
"Grndn",
"Dngrn",
"Ccgrndn",
"Grnccdn"
],
"default": "Grn",
"type": "string"
},
"dranai": {
"description": "DRA nature of address indicator. The DRA NAI that is used during number conditioning.",
"maximum": 127,
"minimum": 1,
"default": 3,
"type": "integer"
},
"nai2ton": {
"description": "NAI to TON Mapping. NAI and TON values are separated by '-'. Multiple mappings can be provided separated by ','. Valid values for NAI lies between 1 to 127. Valid values for TON lies between 0 and 7.",
"pattern": "^(((([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7]))(-)([0-7]))(,))*((([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7])))(-)([0-7])$",
"type": "string"
},
"nptype": {
"description": "Entity type for CdPN RTDB lookup. The entity type that is considered a success when used for RTDB lookup.",
"enum" : [
"Sp",
"Rn",
"Rnsp",
"Anymatch",
"Always",
"Rnspdn"
],
"default" : "Rnsp",
"type": "string"
},
"rnspfill": {
"description": "This parameter specifies whether the RN and SP entities are set to the value of the RN or SP digits from the RTDB when certain conditions are met.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"spfill": {
"description": "This parameter specifies whether the SP entity type is populated if the value specified for the dfltrn or grn parameter is used for NPP processing.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"snai": {
"description": "CdPN nature of address indicator. The CdPN NAI used during number conditioning.",
"enum" : [
"Incoming",
"Natl",
"Intl",
"Unkn"
],
"default": "Incoming",
"type": "string"
},
"ton2nai": {
"description": "TON to NAI Mapping. TON and NAI values are separated by '-'. Multiple mappings can be provided separated by ','. Valid value for TON lies between 0 and 7. Valid values for NAI lies between 1 to 127.",
"pattern": "^(([0-7])(-)(([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7]))(,))*(([0-7])(-)(([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7])))$",
"type": "string"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"cdcnp": "Off",
"cddnnotfndrsp": "Release",
"cddra": "Rndn",
"cddranai": "Natl",
"cddranp": "E164",
"cdnoentityrsp": "Continue",
"cdrelcause": 31,
"cdrnrsp": "Connect",
"cdsprsp": "Relay",
"cgcnp": "Off",
"cgdnnotfndrsp": "Release",
"cgdra": "Rndn",
"cgdranai": "Natl",
"cgdranp": "E164",
"cgnoentityrsp": "Continue",
"cgnptype": "Rnsp",
"cgpaccck": "Nonintl",
"cgpnskrtg": "No",
"cgrelcause": 31,
"cgrnrsp": "Connect",
"cgsnai": "Incoming",
"cgsprsp": "Relay",
"dfltrn": "None",
"dlma": "None",
"dlmb": "None",
"dlmc": "None",
"drafrmt": "Grn",
"dranai": 3,
"nai2ton": "2-2,1-1",
"nptype": "Rnsp",
"rnspfill": "Off",
"snai": "Incoming",
"ton2nai": "3-1,2-2,4-6"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/idproptions
Update the IDPR Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/idproption/idproption.json",
"properties": {
"cdcnp": {
"description": "Specifies whether the CutAndPaste parameter is included in the CONNECT message generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"cddnnotfndrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the Called Party Number (CdPN) is not found in the RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Release",
"type": "string"
},
"cddra": {
"description": "The destination routing address (DRA) used in the CONNECT message generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"Rn",
"Rndn",
"Grn",
"Rnasd",
"Asdrn",
"Rngrn",
"Grnrn",
"Ccrndn",
"Rnasddn",
"Asdrndn",
"Ccrnasddn",
"Ccasdrndn",
"Asdrnccdn",
"Rnasdccdn",
"Rngrndn",
"Grnrndn",
"Ccrngrndn",
"Ccgrnrndn",
"Grnrnccdn",
"Rngrnccdn",
"Grndn",
"Ccgrndn"
],
"default": "Rndn",
"type": "string"
},
"cddranai": {
"description": "The DRA nature of address indicator used in the CONNECT response generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"Sub",
"Unknown",
"Natl",
"Intl",
"Ntwk"
],
"default": "Natl",
"type": "string"
},
"cddranp": {
"description": "The DRA numbering plan used in the CONNECT response generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"enum" : [
"E164",
"X121",
"F69"
],
"default": "E164",
"type": "string"
},
"cdnoentityrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when neither the RN nor SP entity is found in the CdPN RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Continue",
"type": "string"
},
"cdrelcause": {
"description": "The cause parameter value for the RELEASECALL message generated by the INPRTG Service Action based on the CdPN RTDB lookup.",
"maximum": 127,
"minimum": 1,
"default": 31,
"type": "integer"
},
"cdrnrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the CdPN is associated with an RN entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Connect",
"type": "string"
},
"cdsprsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the CdPN is associated with an SP entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Relay",
"type": "string"
},
"cgcnp": {
"description": "Specifies whether the CutAndPaste parameter is included in the CONNECT message generated by the INPRTG Service Action based on the CgPN RTDB lookup.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"cgdnnotfndrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the Calling Party Number (CgPN) is not found in the RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Release",
"type": "string"
},
"cgdra": {
"description": "The DRA used in the CONNECT response generated by the INPRTG Service Action based on the CGPN RTDB lookup.",
"enum" : [
"Rn",
"Rndn",
"Grn",
"Rnasd",
"Asdrn",
"Rngrn",
"Grnrn",
"Ccrndn",
"Rnasddn",
"Asdrndn",
"Ccrnasddn",
"Ccasdrndn",
"Asdrnccdn",
"Rnasdccdn",
"Rngrndn",
"Grnrndn",
"Ccrngrndn",
"Ccgrnrndn",
"Grnrnccdn",
"Rngrnccdn",
"Grndn",
"Ccgrndn"
],
"default": "Rndn",
"type": "string"
},
"cgdranai": {
"description": "The NAI option used in the CONNECT response generated by the INPRTG Service Action based on the CgPN lookup.",
"enum" : [
"Sub",
"Unknown",
"Natl",
"Intl",
"Ntwk"
],
"default": "Natl",
"type": "string"
},
"cgdranp": {
"description": "The DRA NP used in the CONNECT response generated by the INPRTG Service Action based on the CgPN lookup.",
"enum" : [
"E164",
"X121",
"F69"
],
"default": "E164",
"type": "string"
},
"cgnoentityrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when neither the RN nor SP entity is found in the CgPN RTDB.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Continue",
"type": "string"
},
"cgnptype": {
"description": "CgPN database lookup type. The entity type that is considered a success when used for RTDB lookup.",
"enum" : [
"Sp",
"Rn",
"Rnsp",
"Anymatch",
"Always",
"Rnspdn"
],
"default": "Rnsp",
"type": "string"
},
"cgpaccck": {
"description": "CgPA country code check. This parameter specifies whether a DEFCC check is performed on the incoming CgPA.",
"enum" : [
"Always",
"Nonintl",
"Off"
],
"default": "Nonintl",
"type": "string"
},
"cgpnskrtg": {
"description": "This parameter specifies whether SK routing occurs if IDP A-Party routing fails.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"cgrelcause": {
"description": "The cause parameter value in the RELEASECALL message generated by an INPRTG Service Action based on the CgPN RTDB lookup.",
"maximum": 127,
"minimum": 1,
"default": 31,
"type": "integer"
},
"cgrnrsp": {
"description": "The system response for an IDP message processed by the IDPR/TTR service when the CgPN is associated with an RN entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Connect",
"type": "string"
},
"cgsnai": {
"description": "Calling party number nature of address indicator. The CgPN NAI that is used during number conditioning.",
"enum" : [
"Incoming",
"Intl",
"Natl",
"Unkn"
],
"default": "Incoming",
"type": "string"
},
"cgsprsp": {
"description": "The system response sent for an IDP message processed by the IDPR/TTR service when the CgPN is associated with an SP entity.",
"enum" : [
"Connect",
"Continue",
"Relay",
"Release"
],
"default": "Relay",
"type": "string"
},
"dfltrn": {
"description": "Default routing number. The default RN used when a value of sp or rnsp is specified for the nptype parameter, and the CdPN RTDB lookup returns entity type SP.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlma": {
"description": "Delimiter A. The first delimiter used to format the outgoing TCAP DN.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmb": {
"description": "Delimiter B. The second delimiter used to format the outgoing TCAP DN.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmc": {
"description": "Delimiter C. The third delimiter used to format the outgoing TCAP DN.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"drafrmt": {
"description": "DRA digit format. The format of the DRA digits.",
"enum" : [
"Grn",
"Grndn",
"Dngrn",
"Ccgrndn",
"Grnccdn"
],
"default": "Grn",
"type": "string"
},
"dranai": {
"description": "DRA nature of address indicator. The DRA NAI that is used during number conditioning.",
"maximum": 127,
"minimum": 1,
"default": 3,
"type": "integer"
},
"nai2ton": {
"description": "NAI to TON Mapping. NAI and TON values are separated by '-'. Multiple mappings can be provided separated by ','. Valid values for NAI lies between 1 to 127. Valid values for TON lies between 0 and 7.",
"pattern": "^(((([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7]))(-)([0-7]))(,))*((([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7])))(-)([0-7])$",
"type": "string"
},
"nptype": {
"description": "Entity type for CdPN RTDB lookup. The entity type that is considered a success when used for RTDB lookup.",
"enum" : [
"Sp",
"Rn",
"Rnsp",
"Anymatch",
"Always",
"Rnspdn"
],
"default" : "Rnsp",
"type": "string"
},
"rnspfill": {
"description": "This parameter specifies whether the RN and SP entities are set to the value of the RN or SP digits from the RTDB when certain conditions are met.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"spfill": {
"description": "This parameter specifies whether the SP entity type is populated if the value specified for the dfltrn or grn parameter is used for NPP processing.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"snai": {
"description": "CdPN nature of address indicator. The CdPN NAI used during number conditioning.",
"enum" : [
"Incoming",
"Natl",
"Intl",
"Unkn"
],
"default": "Incoming",
"type": "string"
},
"ton2nai": {
"description": "TON to NAI Mapping. TON and NAI values are separated by '-'. Multiple mappings can be provided separated by ','. Valid value for TON lies between 0 and 7. Valid values for NAI lies between 1 to 127.",
"pattern": "^(([0-7])(-)(([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7]))(,))*(([0-7])(-)(([1-9]|[1-9][0-9])|([1][0-1][0-9])|(12[0-7])))$",
"type": "string"
}
},
"required": [],
"type": "object"
}
Example
{
"cdcnp": "Off",
"cddnnotfndrsp": "Release",
"cddra": "Rndn",
"cddranai": "Natl",
"cddranp": "E164",
"cdnoentityrsp": "Continue",
"cdrelcause": 31,
"cdrnrsp": "Connect",
"cdsprsp": "Relay",
"cgcnp": "Off",
"cgdnnotfndrsp": "Release",
"cgdra": "Rndn",
"cgdranai": "Natl",
"cgdranp": "E164",
"cgnoentityrsp": "Continue",
"cgnptype": "Rnsp",
"cgpaccck": "Nonintl",
"cgpnskrtg": "No",
"cgrelcause": 31,
"cgrnrsp": "Connect",
"cgsnai": "Incoming",
"cgsprsp": "Relay",
"dfltrn": "None",
"dlma": "None",
"dlmb": "None",
"dlmc": "None",
"drafrmt": "Grn",
"dranai": 3,
"nai2ton": "2-2,1-1",
"nptype": "Rnsp",
"rnspfill": "Off",
"snai": "Incoming",
"ton2nai": "3-1,2-2,4-6"
}
Vstp: Links
A Link carries signaling within a Linkset (/vstp/linksets) using a specific Connection (/vstp/connections). A Link can belong to only one Linkset and one Connection. If a Link fails, the Signaling Network Interface attempts to divert signaling traffic to another Link in the same Linkset. Links cannot be edited. A Link can be changed only by deleting it and adding the changed Link.
All configuration of the Links is done at the SOAM.
/vstp/links
get /vstp/links
Returns all Links that meet the criteria specified in the GET request. By default, all Links configured at the SOAM are returned. If paging parameters are supplied, only those Links meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/linkCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/link/links.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionName": {
"description": "This defines the name of the Connection (/vstp/connections) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"channelName": {
"description": "PCI card interface identifier.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"linksetName": {
"description": "This defines the name of the Linkset (/vstp/linksets) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this Link, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"signalingLinkCode": {
"description": "Defines the Signaling Link Code (SLC). The SLC must be unique within the Link Set (/vstp/linksets), and it must have the same value at both the VSTP and the distant Node.",
"maximum": 15,
"minimum": 0,
"type": "integer"
}
},
"required": [
"linksetName",
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "1",
"connectionName": "Conn1",
"linksetName": "ls1",
"name": "link1",
"signalingLinkCode": 5
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/links
Adds a new Link to the VSTP configuration. The Link name must be unique across all Links at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/link/links.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionName": {
"description": "This defines the name of the Connection (/vstp/connections) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"channelName": {
"description": "PCI card interface identifier.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"linksetName": {
"description": "This defines the name of the Linkset (/vstp/linksets) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this Link, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"signalingLinkCode": {
"description": "Defines the Signaling Link Code (SLC). The SLC must be unique within the Link Set (/vstp/linksets), and it must have the same value at both the VSTP and the distant Node.",
"maximum": 15,
"minimum": 0,
"type": "integer"
}
},
"required": [
"linksetName",
"name"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"connectionName": "Conn1",
"linksetName": "ls1",
"name": "link1",
"signalingLinkCode": 5
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/links/status
get /vstp/links/status
Returns the status of all Links that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data (except operationalReason, statusKnown - these attributes cannot be filtered). Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, or IN. LIKE is not supported for these data types. Boolean attributes can be filtered using only EQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=linksetName
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=link1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/linkstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/link/linkstatus.json",
"properties": {
"linkAdminState": {
"description": "The administrative state of this Link. A Link in the Disabled state cannot become established; it must first be placed into the Enabled state to bring the Link to the ASP-Active state. It indicates to a Remote Host (/vstp/remotehosts) that VSTP-MP server is active and ready for use.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"linksetName": {
"description": "The name of the Linkset (/vstp/linksets) associated with this Link.",
"type": "string"
},
"linkType": {
"description": "This defines the type of link. When set to M3ua, the Link is of type MTP3 User Adaptation Layer. When set to M2pa, the Link is of type MTP2 User Peer-to-Peer Adaptation Layer.",
"enum": [
"M3ua",
"M2pa",
"Mtp2"
],
"type": "string"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the VSTP-MP server that is currently reporting the status of this Link.",
"type": "string"
},
"name": {
"description": "The configured name of the Link.",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Link.",
"type": "string"
},
"operationalStatus": {
"description": "The current operational state of the Link. While this attribute can have a value of OOS, Alignment, Proving, Ready, Busy, InService, or Retrieval, the operationalReason attribute typically contains additional information elaborating on the reported operationalStatus.",
"enum": [
"OOS",
"Alignment",
"Proving",
"Ready",
"Busy",
"InService",
"Retrieval"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Link are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this Link, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Link was last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"linkAdminState": "Disabled",
"linksetName": "LinkTestLinkset1",
"linkType": "M3ua",
"mpServerHostname": "VSTPMP1",
"name": "LinkTestLink1",
"operationalReason": "Disabled by Application",
"operationalStatus": "OOS",
"statusKnown": true,
"timeOfLastUpdate": "1969-12-31T19:00:00-05:00"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/vstp/links/{name}
get /vstp/links/{name}
Returns the configuration details for the specified Link. If the Link does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/linkItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/link/links.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"connectionName": {
"description": "This defines the name of the Connection (/vstp/connections) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"channelName": {
"description": "PCI card interface identifier.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"linksetName": {
"description": "This defines the name of the Linkset (/vstp/linksets) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this Link, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"signalingLinkCode": {
"description": "Defines the Signaling Link Code (SLC). The SLC must be unique within the Link Set (/vstp/linksets), and it must have the same value at both the VSTP and the distant Node.",
"maximum": 15,
"minimum": 0,
"type": "integer"
}
},
"required": [
"linksetName",
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "1",
"connectionName": "Conn1",
"linksetName": "ls1",
"name": "link1",
"signalingLinkCode": 5
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/links/{name}
delete /vstp/links/{name}
Deletes the specified Link from the SOAM configuration. A Link can only be deleted if all delete validation checks pass. In general, if the Link is enabled, the Link cannot be deleted. The Link must first be disabled, then it can be deleted from the configuration. An attempt to delete a Link that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/vstp/links/{name}/status
get /vstp/links/{name}/status
Retrieves the operational status for the specified Link.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/linkstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/link/linkstatus.json",
"properties": {
"linkAdminState": {
"description": "The administrative state of this Link. A Link in the Disabled state cannot become established; it must first be placed into the Enabled state to bring the Link to the ASP-Active state. It indicates to a Remote Host (/vstp/remotehosts) that VSTP-MP server is active and ready for use.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"linksetName": {
"description": "The name of the Linkset (/vstp/linksets) associated with this Link.",
"type": "string"
},
"linkType": {
"description": "This defines the type of link. When set to M3ua, the Link is of type MTP3 User Adaptation Layer. When set to M2pa, the Link is of type MTP2 User Peer-to-Peer Adaptation Layer.",
"enum": [
"M3ua",
"M2pa",
"Mtp2"
],
"type": "string"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the VSTP-MP server that is currently reporting the status of this Link.",
"type": "string"
},
"name": {
"description": "The configured name of the Link.",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Link.",
"type": "string"
},
"operationalStatus": {
"description": "The current operational state of the Link. While this attribute can have a value of OOS, Alignment, Proving, Ready, Busy, InService, or Retrieval, the operationalReason attribute typically contains additional information elaborating on the reported operationalStatus.",
"enum": [
"OOS",
"Alignment",
"Proving",
"Ready",
"Busy",
"InService",
"Retrieval"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Link are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this Link, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Link was last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"linkAdminState": "Disabled",
"linksetName": "LinkTestLinkset1",
"linkType": "M3ua",
"mpServerHostname": "VSTPMP1",
"name": "LinkTestLink1",
"operationalReason": "Disabled by Application",
"operationalStatus": "OOS",
"statusKnown": true,
"timeOfLastUpdate": "1969-12-31T19:00:00-05:00"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/vstp/links/{name}/linkadminstate
get /vstp/links/{name}/linkadminstate
Retrieves the administrative state, which can be either Enabled or Disabled, for the specified Link.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/linkadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schema/vstp/link/linkadminstate.json",
"properties": {
"adminState": {
"description": "A Link's administrative state can be either Enabled or Disabled. A Link's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": ["adminState"],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/links/{name}/linkadminstate
Updates the administrative state for the specified VSTP Link to either Enabled or Disabled.
A Link's configuration cannot be modified or deleted if its administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/vstp/link/linkadminstate.json",
"properties": {
"adminState": {
"description": "A Link's administrative state can be either Enabled or Disabled. A Link's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"example": "Enabled",
"type": "string"
}
},
"required": ["adminState"],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
Vstp: Link Sets
A Link Set is a logical element representing link attributes assigned to a Link (/vstp/links) and a far-end point assigned to a Route (/vstp/routes).
All configuration of Link Sets is done at the SOAM.
/vstp/linksets
get /vstp/linksets
Returns all Link Sets that meet the criteria specified in the GET request. By default, all Link Sets configured at the SOAM are returned. If paging parameters are supplied, only those Link Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/linksetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/links/linksets.json",
"properties": {
"asNotification": {
"description": "Application Server (AS) notification. Only applies when the adaptor type (type attribute) is set to M3ua. When asNotification is set to true, AS notifications are sent on M3ua linksets. When set to false, AS notifications are not sent. Default is true.",
"type": "boolean"
},
"asls8": {
"description": "Adjacent SLS 8-bit indicator. This parameter specifies whether the adjacent node is sending MSUs with 8-bit SLSs.",
"default":false,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"enableBroadcastException": {
"description": "When the linkset status changes, the VSTP broadcasts TFP/TFA to adjacent nodes. When enableBroadcastException is set to true, this broadcast is not performed. Typical value is false.",
"type": "boolean"
},
"gttmode": {
"description": "Global title translation mode. The GTT Mode hierarchy for this link set.",
"enum": [
"Cd",
"Fcd",
"Fcg",
"Fcgfcd",
"Fcdfcg",
"Sysdflt"
],
"default": "Sysdflt",
"type": "string"
},
"ituTransferRestricted": {
"description": "ITU TFR (Transfer Restricted) indicator. When set to false, the TFR procedure is turned off for this linkset. ituTransferRestricted only applies to ITU national linksets. Typical value is false.",
"type": "boolean"
},
"islsrsb": {
"description": "Incoming rotated sinaling link selection (SLS) bit. The bit (1-4) for ITU and (1-8) for ANSI link sets to rotate as the new SLS LSB (Least Significant Bit) of the incoming linkset.The SLS is not modified in the outgoing message",
"maximum": 8,
"minimum": 1,
"default": 1,
"type": "integer"
},
"linksetAccMeasOption": {
"description": "Link Set Accounting Measurement Option. This parameter specifies whether the accounting measurement option for the link set is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"reservedLinkTransactionsPerSecond": {
"description": "This parameter specifies Gauranteed Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"maximumLinkTransactionsPerSecond": {
"description": "This parameter specifies Maximum Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"localSignalingPointName": {
"description": "Name of the Local Signaling Point (/vstp/localsignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l2TimerSetName": {
"description": "Configuration Timers associated with this Link Set.Timers can be of MTP2, M2PA or M3UA type based on the adaptor typepresent in linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l3TimerSetName": {
"description": "MTP3 Configuration Timers associated with linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrEventLog": {
"description": "MTP Screening Event Logging. Specifies whether the MTP Screening Event Logging is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"mtpScrSetName": {
"description": "Name of the MTP Screenset /vstp/mtpscreensets/ attached with this Linkset.",
"maxLength": 8,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrTestMode": {
"description": "MTP Screening test mode. Specifies whether the MTP Screening Test Mode is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Link Set, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"numberSignalingLinkAllowedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be allowed with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"numberSignalingLinkProhibitedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be prohibited with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"randsls": {
"description": "Random SLS (signaling link selection).This parameter is used to apply random SLS generation on a per linkset basis.",
"enum": [
"Off",
"All",
"Class0"
],
"default": "Off",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Adjacent Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingContext": {
"description": "When the linkset type is M3ua, this value defines the routing context associated with the Link Set.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"rsls8": {
"description": "Rotate SLS by 5 or 8 bits. This parameter specifies whether the signaling link selector (SLS) of the incoming ANSI linkset is rotated by 5 or 8 bits.",
"default": false,
"type": "boolean"
},
"slsci": {
"description": "This parameter specifies whether the 5-bit to 8-bit SLS conversion feature is used to select links for outgoing messages direct to the given linkset.",
"default": false,
"type": "boolean"
},
"slsrsb": {
"description": "Rotated SLS (Signaling Link Selection) Bit. The bit (1-4) to rotate as the new SLS LSB (Least Significant Bit). The SLS is not modified in the outgoing message.",
"maximum": 4,
"minimum": 1,
"default": 1,
"type": "integer"
},
"slsocbit": {
"description": "Other CIC (Circuit Identification Code) Bit. If the SLSOCB feature is turned on, this parameter specifies whether the Other CIC Bit option is to be used during link selection.",
"maximum": 16,
"minimum": 5,
"type": "integer"
},
"securityLogging": {
"description": "Options to generate logs linkset wise.",
"enum": [
"Off",
"Risky",
"All"
],
"default": "Off",
"type": "string"
},
"smsProxy": {
"description": "Option to send to SMS Proxy for HOMESMSC Feature.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"type": {
"description": "Type of the VSTP adapter layer.",
"enum": [
"M3ua",
"M2pa",
"Mtp2"
],
"type": "string"
},
"cgpnblSet" : {
"description": "CGPN Blacklist Set Id for screening directory number per linkset referred in Linkset table. The allowed range is 1-255 and the default value is None.",
"maxLength": 4,
"pattern": "^([0-9]{1,3})|None$",
"default": "None",
"type": "string"
},
"gnameset": {
"description": "Generic Name Set",
"enum": [
"SetA",
"SetB",
"Both"
],
"default": "Both",
"type": "string"
}
},
"required": [
"localSignalingPointName",
"reservedLinkTransactionsPerSecond",
"name",
"remoteSignalingPointName",
"type"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"asNotification": true,
"configurationLevel": "0",
"cgGtmod": false,
"enableBroadcastException": true,
"gttmode": "Fcd",
"ituTransferRestricted": false,
"reservedLinkTransactionsPerSecond": 100,
"maximumLinkTransactionsPerSecond": 120,
"localSignalingPointName": "TestItua",
"mtpScrSetName": "scrSet1",
"mtpScrTestMode": true,
"mtpScrEventLog": true,
"name": "Test",
"numberSignalingLinkAllowedThreshold": 1,
"numberSignalingLinkProhibitedThreshold": 1,
"remoteSignalingPointName": "gkAnsi",
"routingContext": 8,
"smsProxy": "Off",
"type": "M3ua"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/linksets
Adds a new Link Set to the VSTP configuration. The Link Set name must be unique across all Link Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/links/linksets.json",
"properties": {
"asNotification": {
"description": "Application Server (AS) notification. Only applies when the adaptor type (type attribute) is set to M3ua. When asNotification is set to true, AS notifications are sent on M3ua linksets. When set to false, AS notifications are not sent. Default is true.",
"type": "boolean"
},
"asls8": {
"description": "Adjacent SLS 8-bit indicator. This parameter specifies whether the adjacent node is sending MSUs with 8-bit SLSs.",
"default":false,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"enableBroadcastException": {
"description": "When the linkset status changes, the VSTP broadcasts TFP/TFA to adjacent nodes. When enableBroadcastException is set to true, this broadcast is not performed. Typical value is false.",
"type": "boolean"
},
"gttmode": {
"description": "Global title translation mode. The GTT Mode hierarchy for this link set.",
"enum": [
"Cd",
"Fcd",
"Fcg",
"Fcgfcd",
"Fcdfcg",
"Sysdflt"
],
"default": "Sysdflt",
"type": "string"
},
"ituTransferRestricted": {
"description": "ITU TFR (Transfer Restricted) indicator. When set to false, the TFR procedure is turned off for this linkset. ituTransferRestricted only applies to ITU national linksets. Typical value is false.",
"type": "boolean"
},
"islsrsb": {
"description": "Incoming rotated sinaling link selection (SLS) bit. The bit (1-4) for ITU and (1-8) for ANSI link sets to rotate as the new SLS LSB (Least Significant Bit) of the incoming linkset.The SLS is not modified in the outgoing message",
"maximum": 8,
"minimum": 1,
"default": 1,
"type": "integer"
},
"linksetAccMeasOption": {
"description": "Link Set Accounting Measurement Option. This parameter specifies whether the accounting measurement option for the link set is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"reservedLinkTransactionsPerSecond": {
"description": "This parameter specifies Gauranteed Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"maximumLinkTransactionsPerSecond": {
"description": "This parameter specifies Maximum Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"localSignalingPointName": {
"description": "Name of the Local Signaling Point (/vstp/localsignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l2TimerSetName": {
"description": "Configuration Timers associated with this Link Set.Timers can be of MTP2, M2PA or M3UA type based on the adaptor typepresent in linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l3TimerSetName": {
"description": "MTP3 Configuration Timers associated with linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrEventLog": {
"description": "MTP Screening Event Logging. Specifies whether the MTP Screening Event Logging is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"mtpScrSetName": {
"description": "Name of the MTP Screenset /vstp/mtpscreensets/ attached with this Linkset.",
"maxLength": 8,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrTestMode": {
"description": "MTP Screening test mode. Specifies whether the MTP Screening Test Mode is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Link Set, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"numberSignalingLinkAllowedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be allowed with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"numberSignalingLinkProhibitedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be prohibited with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"randsls": {
"description": "Random SLS (signaling link selection).This parameter is used to apply random SLS generation on a per linkset basis.",
"enum": [
"Off",
"All",
"Class0"
],
"default": "Off",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Adjacent Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingContext": {
"description": "When the linkset type is M3ua, this value defines the routing context associated with the Link Set.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"rsls8": {
"description": "Rotate SLS by 5 or 8 bits. This parameter specifies whether the signaling link selector (SLS) of the incoming ANSI linkset is rotated by 5 or 8 bits.",
"default": false,
"type": "boolean"
},
"slsci": {
"description": "This parameter specifies whether the 5-bit to 8-bit SLS conversion feature is used to select links for outgoing messages direct to the given linkset.",
"default": false,
"type": "boolean"
},
"slsrsb": {
"description": "Rotated SLS (Signaling Link Selection) Bit. The bit (1-4) to rotate as the new SLS LSB (Least Significant Bit). The SLS is not modified in the outgoing message.",
"maximum": 4,
"minimum": 1,
"default": 1,
"type": "integer"
},
"slsocbit": {
"description": "Other CIC (Circuit Identification Code) Bit. If the SLSOCB feature is turned on, this parameter specifies whether the Other CIC Bit option is to be used during link selection.",
"maximum": 16,
"minimum": 5,
"type": "integer"
},
"securityLogging": {
"description": "Options to generate logs linkset wise.",
"enum": [
"Off",
"Risky",
"All"
],
"default": "Off",
"type": "string"
},
"smsProxy": {
"description": "Option to send to SMS Proxy for HOMESMSC Feature.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"type": {
"description": "Type of the VSTP adapter layer.",
"enum": [
"M3ua",
"M2pa",
"Mtp2"
],
"type": "string"
},
"cgpnblSet" : {
"description": "CGPN Blacklist Set Id for screening directory number per linkset referred in Linkset table. The allowed range is 1-255 and the default value is None.",
"maxLength": 4,
"pattern": "^([0-9]{1,3})|None$",
"default": "None",
"type": "string"
},
"gnameset": {
"description": "Generic Name Set",
"enum": [
"SetA",
"SetB",
"Both"
],
"default": "Both",
"type": "string"
}
},
"required": [
"localSignalingPointName",
"reservedLinkTransactionsPerSecond",
"name",
"remoteSignalingPointName",
"type"
],
"type": "object"
}
Example
{
"asNotification": true,
"configurationLevel": "0",
"cgGtmod": false,
"enableBroadcastException": true,
"gttmode": "Fcd",
"ituTransferRestricted": false,
"reservedLinkTransactionsPerSecond": 100,
"maximumLinkTransactionsPerSecond": 120,
"localSignalingPointName": "TestItua",
"mtpScrSetName": "scrSet1",
"mtpScrTestMode": true,
"mtpScrEventLog": true,
"name": "Test",
"numberSignalingLinkAllowedThreshold": 1,
"numberSignalingLinkProhibitedThreshold": 1,
"remoteSignalingPointName": "gkAnsi",
"routingContext": 8,
"smsProxy": "Off",
"type": "M3ua"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/linksets/status
get /vstp/linksets/status
Returns the status of all Link Sets that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data (except statusKnown - this attribute cannot be filtered). Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, or IN. LIKE is not supported for these data types. Boolean attributes can be filtered using only EQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOTEQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOTEQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=Linkset1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/linksetstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/links/linksetstatus.json",
"properties": {
"congestionLevel": {
"description": "The congestion level of the Link Set. This is the lowest of the congestion levels of all the Links (/vstp/links) configured in the Link Set.",
"enum": [
"Normal",
"CL1",
"CL2",
"CL3"
],
"type": "string"
},
"mpServerHostname": {
"description": "The name of the VSTP-MP server that is currently reporting the status of the Link Set.",
"type": "string"
},
"name": {
"description": "The configured name of the Link Set.",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Link Set. This attribute can have values of All Links Normal, X of Y Links Normal, or Application Disabled. This value depends on the number of Links (/vstp/links) in the Link Set that are in their normal state and the state of the application on the MP server.",
"type": "string"
},
"operationalStatus": {
"description": "The current operational state of the Link Set. This attribute can have a value of Up or Down. When set to Up, the application is running on an active server and at least one Link (/vstp/links) is up. When set to Down, no Links (/vstp/links) are normal or the application is not running on the MP server.",
"enum": [
"Down",
"Up"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, it implies that the current values for the run-time status attributes for this Link Set are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this Link Set. If the OAM has current status for this Link Set, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the operationalStatus for this Link Set was last updated.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"congestionLevel": "Normal",
"mpServerHostname": "Mp1",
"name": "LinkTestLinkset1",
"operationalReason": "No Link Defined",
"operationalStatus": "Down",
"statusKnown": true,
"timeOfLastUpdate": "2017-03-06T19:59:09-05:00"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/vstp/linksets/{name}
get /vstp/linksets/{name}
Returns the configuration details for the specified Link Set. If the Link Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/linksetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/links/linksets.json",
"properties": {
"asNotification": {
"description": "Application Server (AS) notification. Only applies when the adaptor type (type attribute) is set to M3ua. When asNotification is set to true, AS notifications are sent on M3ua linksets. When set to false, AS notifications are not sent. Default is true.",
"type": "boolean"
},
"asls8": {
"description": "Adjacent SLS 8-bit indicator. This parameter specifies whether the adjacent node is sending MSUs with 8-bit SLSs.",
"default":false,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"enableBroadcastException": {
"description": "When the linkset status changes, the VSTP broadcasts TFP/TFA to adjacent nodes. When enableBroadcastException is set to true, this broadcast is not performed. Typical value is false.",
"type": "boolean"
},
"gttmode": {
"description": "Global title translation mode. The GTT Mode hierarchy for this link set.",
"enum": [
"Cd",
"Fcd",
"Fcg",
"Fcgfcd",
"Fcdfcg",
"Sysdflt"
],
"default": "Sysdflt",
"type": "string"
},
"ituTransferRestricted": {
"description": "ITU TFR (Transfer Restricted) indicator. When set to false, the TFR procedure is turned off for this linkset. ituTransferRestricted only applies to ITU national linksets. Typical value is false.",
"type": "boolean"
},
"islsrsb": {
"description": "Incoming rotated sinaling link selection (SLS) bit. The bit (1-4) for ITU and (1-8) for ANSI link sets to rotate as the new SLS LSB (Least Significant Bit) of the incoming linkset.The SLS is not modified in the outgoing message",
"maximum": 8,
"minimum": 1,
"default": 1,
"type": "integer"
},
"linksetAccMeasOption": {
"description": "Link Set Accounting Measurement Option. This parameter specifies whether the accounting measurement option for the link set is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"reservedLinkTransactionsPerSecond": {
"description": "This parameter specifies Gauranteed Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"maximumLinkTransactionsPerSecond": {
"description": "This parameter specifies Maximum Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"localSignalingPointName": {
"description": "Name of the Local Signaling Point (/vstp/localsignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l2TimerSetName": {
"description": "Configuration Timers associated with this Link Set.Timers can be of MTP2, M2PA or M3UA type based on the adaptor typepresent in linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l3TimerSetName": {
"description": "MTP3 Configuration Timers associated with linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrEventLog": {
"description": "MTP Screening Event Logging. Specifies whether the MTP Screening Event Logging is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"mtpScrSetName": {
"description": "Name of the MTP Screenset /vstp/mtpscreensets/ attached with this Linkset.",
"maxLength": 8,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrTestMode": {
"description": "MTP Screening test mode. Specifies whether the MTP Screening Test Mode is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Link Set, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"numberSignalingLinkAllowedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be allowed with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"numberSignalingLinkProhibitedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be prohibited with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"randsls": {
"description": "Random SLS (signaling link selection).This parameter is used to apply random SLS generation on a per linkset basis.",
"enum": [
"Off",
"All",
"Class0"
],
"default": "Off",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Adjacent Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingContext": {
"description": "When the linkset type is M3ua, this value defines the routing context associated with the Link Set.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"rsls8": {
"description": "Rotate SLS by 5 or 8 bits. This parameter specifies whether the signaling link selector (SLS) of the incoming ANSI linkset is rotated by 5 or 8 bits.",
"default": false,
"type": "boolean"
},
"slsci": {
"description": "This parameter specifies whether the 5-bit to 8-bit SLS conversion feature is used to select links for outgoing messages direct to the given linkset.",
"default": false,
"type": "boolean"
},
"slsrsb": {
"description": "Rotated SLS (Signaling Link Selection) Bit. The bit (1-4) to rotate as the new SLS LSB (Least Significant Bit). The SLS is not modified in the outgoing message.",
"maximum": 4,
"minimum": 1,
"default": 1,
"type": "integer"
},
"slsocbit": {
"description": "Other CIC (Circuit Identification Code) Bit. If the SLSOCB feature is turned on, this parameter specifies whether the Other CIC Bit option is to be used during link selection.",
"maximum": 16,
"minimum": 5,
"type": "integer"
},
"securityLogging": {
"description": "Options to generate logs linkset wise.",
"enum": [
"Off",
"Risky",
"All"
],
"default": "Off",
"type": "string"
},
"smsProxy": {
"description": "Option to send to SMS Proxy for HOMESMSC Feature.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"type": {
"description": "Type of the VSTP adapter layer.",
"enum": [
"M3ua",
"M2pa",
"Mtp2"
],
"type": "string"
},
"cgpnblSet" : {
"description": "CGPN Blacklist Set Id for screening directory number per linkset referred in Linkset table. The allowed range is 1-255 and the default value is None.",
"maxLength": 4,
"pattern": "^([0-9]{1,3})|None$",
"default": "None",
"type": "string"
},
"gnameset": {
"description": "Generic Name Set",
"enum": [
"SetA",
"SetB",
"Both"
],
"default": "Both",
"type": "string"
}
},
"required": [
"localSignalingPointName",
"reservedLinkTransactionsPerSecond",
"name",
"remoteSignalingPointName",
"type"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"asNotification": true,
"configurationLevel": "0",
"cgGtmod": false,
"enableBroadcastException": true,
"gttmode": "Fcd",
"ituTransferRestricted": false,
"reservedLinkTransactionsPerSecond": 100,
"maximumLinkTransactionsPerSecond": 120,
"localSignalingPointName": "TestItua",
"mtpScrSetName": "scrSet1",
"mtpScrTestMode": true,
"mtpScrEventLog": true,
"name": "Test",
"numberSignalingLinkAllowedThreshold": 1,
"numberSignalingLinkProhibitedThreshold": 1,
"remoteSignalingPointName": "gkAnsi",
"routingContext": 8,
"smsProxy": "Off",
"type": "M3ua"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/linksets/{name}
Updates the configuration of the specified Link Set. If the provided Link Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/links/linksets.json",
"properties": {
"asNotification": {
"description": "Application Server (AS) notification. Only applies when the adaptor type (type attribute) is set to M3ua. When asNotification is set to true, AS notifications are sent on M3ua linksets. When set to false, AS notifications are not sent. Default is true.",
"type": "boolean"
},
"asls8": {
"description": "Adjacent SLS 8-bit indicator. This parameter specifies whether the adjacent node is sending MSUs with 8-bit SLSs.",
"default":false,
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cgGtmod": {
"description": "Calling party GT modification indicator. This parameter specifies whether calling party global title modification is required. Default is false.",
"default": false,
"type": "boolean"
},
"enableBroadcastException": {
"description": "When the linkset status changes, the VSTP broadcasts TFP/TFA to adjacent nodes. When enableBroadcastException is set to true, this broadcast is not performed. Typical value is false.",
"type": "boolean"
},
"gttmode": {
"description": "Global title translation mode. The GTT Mode hierarchy for this link set.",
"enum": [
"Cd",
"Fcd",
"Fcg",
"Fcgfcd",
"Fcdfcg",
"Sysdflt"
],
"default": "Sysdflt",
"type": "string"
},
"ituTransferRestricted": {
"description": "ITU TFR (Transfer Restricted) indicator. When set to false, the TFR procedure is turned off for this linkset. ituTransferRestricted only applies to ITU national linksets. Typical value is false.",
"type": "boolean"
},
"islsrsb": {
"description": "Incoming rotated sinaling link selection (SLS) bit. The bit (1-4) for ITU and (1-8) for ANSI link sets to rotate as the new SLS LSB (Least Significant Bit) of the incoming linkset.The SLS is not modified in the outgoing message",
"maximum": 8,
"minimum": 1,
"default": 1,
"type": "integer"
},
"linksetAccMeasOption": {
"description": "Link Set Accounting Measurement Option. This parameter specifies whether the accounting measurement option for the link set is On or Off.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"reservedLinkTransactionsPerSecond": {
"description": "This parameter specifies Gauranteed Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"maximumLinkTransactionsPerSecond": {
"description": "This parameter specifies Maximum Link (/vstp/links) transactions per second defined for all the links of this Link Set.",
"maximum": 10000,
"minimum": 10,
"type": "integer"
},
"localSignalingPointName": {
"description": "Name of the Local Signaling Point (/vstp/localsignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l2TimerSetName": {
"description": "Configuration Timers associated with this Link Set.Timers can be of MTP2, M2PA or M3UA type based on the adaptor typepresent in linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"l3TimerSetName": {
"description": "MTP3 Configuration Timers associated with linkset.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrEventLog": {
"description": "MTP Screening Event Logging. Specifies whether the MTP Screening Event Logging is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"mtpScrSetName": {
"description": "Name of the MTP Screenset /vstp/mtpscreensets/ attached with this Linkset.",
"maxLength": 8,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mtpScrTestMode": {
"description": "MTP Screening test mode. Specifies whether the MTP Screening Test Mode is true or false. Default value is false.",
"default": false,
"type": "boolean"
},
"name": {
"description": "Name for this Link Set, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"numberSignalingLinkAllowedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be allowed with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"numberSignalingLinkProhibitedThreshold": {
"description": "Threshold value for number of Links (/vstp/links) which can be prohibited with this Link Set. This is applicable only for M3ua linksets. Default is 1.",
"maximum": 16,
"minimum": 0,
"type": "integer"
},
"randsls": {
"description": "Random SLS (signaling link selection).This parameter is used to apply random SLS generation on a per linkset basis.",
"enum": [
"Off",
"All",
"Class0"
],
"default": "Off",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Adjacent Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routingContext": {
"description": "When the linkset type is M3ua, this value defines the routing context associated with the Link Set.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"rsls8": {
"description": "Rotate SLS by 5 or 8 bits. This parameter specifies whether the signaling link selector (SLS) of the incoming ANSI linkset is rotated by 5 or 8 bits.",
"default": false,
"type": "boolean"
},
"slsci": {
"description": "This parameter specifies whether the 5-bit to 8-bit SLS conversion feature is used to select links for outgoing messages direct to the given linkset.",
"default": false,
"type": "boolean"
},
"slsrsb": {
"description": "Rotated SLS (Signaling Link Selection) Bit. The bit (1-4) to rotate as the new SLS LSB (Least Significant Bit). The SLS is not modified in the outgoing message.",
"maximum": 4,
"minimum": 1,
"default": 1,
"type": "integer"
},
"slsocbit": {
"description": "Other CIC (Circuit Identification Code) Bit. If the SLSOCB feature is turned on, this parameter specifies whether the Other CIC Bit option is to be used during link selection.",
"maximum": 16,
"minimum": 5,
"type": "integer"
},
"securityLogging": {
"description": "Options to generate logs linkset wise.",
"enum": [
"Off",
"Risky",
"All"
],
"default": "Off",
"type": "string"
},
"smsProxy": {
"description": "Option to send to SMS Proxy for HOMESMSC Feature.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"type": {
"description": "Type of the VSTP adapter layer.",
"enum": [
"M3ua",
"M2pa",
"Mtp2"
],
"type": "string"
},
"cgpnblSet" : {
"description": "CGPN Blacklist Set Id for screening directory number per linkset referred in Linkset table. The allowed range is 1-255 and the default value is None.",
"maxLength": 4,
"pattern": "^([0-9]{1,3})|None$",
"default": "None",
"type": "string"
},
"gnameset": {
"description": "Generic Name Set",
"enum": [
"SetA",
"SetB",
"Both"
],
"default": "Both",
"type": "string"
}
},
"required": [
"localSignalingPointName",
"reservedLinkTransactionsPerSecond",
"name",
"remoteSignalingPointName",
"type"
],
"type": "object"
}
Example
{
"asNotification": true,
"configurationLevel": "0",
"cgGtmod": false,
"enableBroadcastException": true,
"gttmode": "Fcd",
"ituTransferRestricted": false,
"reservedLinkTransactionsPerSecond": 100,
"maximumLinkTransactionsPerSecond": 120,
"localSignalingPointName": "TestItua",
"mtpScrSetName": "scrSet1",
"mtpScrTestMode": true,
"mtpScrEventLog": true,
"name": "Test",
"numberSignalingLinkAllowedThreshold": 1,
"numberSignalingLinkProhibitedThreshold": 1,
"remoteSignalingPointName": "gkAnsi",
"routingContext": 8,
"smsProxy": "Off",
"type": "M3ua"
}
delete /vstp/linksets/{name}
Deletes the specified Link Set from the SOAM configuration. A Link Set can only be deleted if all delete validation checks pass. If the Link Set is part of the configuration of one or more Links (/vstp/links), the Link Set must first be removed from the Link (/vstp/links). An attempt to delete a Link Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/vstp/linksets/{name}/status
get /vstp/linksets/{name}/status
Retrieves the operational status for the specified Link Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/linksetstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/links/linksetstatus.json",
"properties": {
"congestionLevel": {
"description": "The congestion level of the Link Set. This is the lowest of the congestion levels of all the Links (/vstp/links) configured in the Link Set.",
"enum": [
"Normal",
"CL1",
"CL2",
"CL3"
],
"type": "string"
},
"mpServerHostname": {
"description": "The name of the VSTP-MP server that is currently reporting the status of the Link Set.",
"type": "string"
},
"name": {
"description": "The configured name of the Link Set.",
"type": "string"
},
"operationalReason": {
"description": "Information elaborating on the current operationalStatus of the Link Set. This attribute can have values of All Links Normal, X of Y Links Normal, or Application Disabled. This value depends on the number of Links (/vstp/links) in the Link Set that are in their normal state and the state of the application on the MP server.",
"type": "string"
},
"operationalStatus": {
"description": "The current operational state of the Link Set. This attribute can have a value of Up or Down. When set to Up, the application is running on an active server and at least one Link (/vstp/links) is up. When set to Down, no Links (/vstp/links) are normal or the application is not running on the MP server.",
"enum": [
"Down",
"Up"
],
"type": "string"
},
"statusKnown": {
"description": "When set to false, it implies that the current values for the run-time status attributes for this Link Set are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this Link Set. If the OAM has current status for this Link Set, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the operationalStatus for this Link Set was last updated.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"congestionLevel": "Normal",
"mpServerHostname": "Mp1",
"name": "LinkTestLinkset1",
"operationalReason": "No Link Defined",
"operationalStatus": "Down",
"statusKnown": true,
"timeOfLastUpdate": "2017-03-06T19:59:09-05:00"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Vstp: Local Hosts
A Local Host is the VSTP's logical representation of a local node, accessible over one or more transport connections, with which the VSTP can transact VSTP messages. The Local Host managed object encapsulates all the characteristics of the local node that the VSTP must know about in order to communicate successfully with it.
All Local Host configuration is done at the SOAM.
/vstp/localhosts
get /vstp/localhosts
Returns all Local Hosts that meet the criteria specified in the GET request. By default, all Local Hosts configured at the SOAM are returned. If paging parameters are supplied, only those Local Hosts meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/localhostCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localhost/localhost.json",
"properties": {
"localHostName": {
"description": "Name for the Local Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localHostPort": {
"description": "Listen Port number of this Local Host. This is mandatory attribute for local host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"localHostPriIPAddress": {
"description": "Primary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for local host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localHostSecIPAddress": {
"description": "Secondary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"localHostName",
"localHostPort",
"localHostPriIPAddress"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "0",
"localHostName": "LocalHost1",
"localHostPort": 2346,
"localHostPriIPAddress": "10.10.1.10",
"localHostSecIPAddress": "10.10.1.11",
"localHostType": "Local"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/localhosts
Adds a new Local Host to the VSTP configuration. The new Local Host must have a name that is unique across all Local Hosts at the SOAM. In addition, the Local Host's IP Port combination must also be unique across all Local Hosts configured at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localhost/localhost.json",
"properties": {
"localHostName": {
"description": "Name for the Local Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localHostPort": {
"description": "Listen Port number of this Local Host. This is mandatory attribute for local host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"localHostPriIPAddress": {
"description": "Primary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for local host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localHostSecIPAddress": {
"description": "Secondary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"localHostName",
"localHostPort",
"localHostPriIPAddress"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"localHostName": "LocalHost1",
"localHostPort": 2346,
"localHostPriIPAddress": "10.10.1.10",
"localHostSecIPAddress": "10.10.1.11",
"localHostType": "Local"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/localhosts/{name}
get /vstp/localhosts/{name}
Returns the configuration details for the specified Local Host. If the specified Local Host does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/localhostItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localhost/localhost.json",
"properties": {
"localHostName": {
"description": "Name for the Local Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localHostPort": {
"description": "Listen Port number of this Local Host. This is mandatory attribute for local host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"localHostPriIPAddress": {
"description": "Primary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for local host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localHostSecIPAddress": {
"description": "Secondary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"localHostName",
"localHostPort",
"localHostPriIPAddress"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"localHostName": "LocalHost1",
"localHostPort": 2346,
"localHostPriIPAddress": "10.10.1.10",
"localHostSecIPAddress": "10.10.1.11",
"localHostType": "Local"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/localhosts/{name}
Updates the configuration for the specified Local Host. If the provided Local Host data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localhost/localhost.json",
"properties": {
"localHostName": {
"description": "Name for the Local Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"localHostPort": {
"description": "Listen Port number of this Local Host. This is mandatory attribute for local host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"localHostPriIPAddress": {
"description": "Primary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for local host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"localHostSecIPAddress": {
"description": "Secondary IP address of this Local Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"localHostName",
"localHostPort",
"localHostPriIPAddress"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"localHostName": "LocalHost1",
"localHostPort": 2346,
"localHostPriIPAddress": "10.10.1.10",
"localHostSecIPAddress": "10.10.1.11",
"localHostType": "Local"
}
delete /vstp/localhosts/{name}
Deletes the specified Local Host from the SOAM configuration. A Local Host is only deleted if all delete validation checks pass. In general, if the Local Host is part of the configuration of some other resource instance, the Local Host cannot be deleted. For example, if the Local Host is named in a Connection (/vstp/connections), the Local Host must first be removed from the Connection. Then the Local Host can be deleted from the configuration. An attempt to delete a Local Host that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Local Signaling Points
A Signaling Point is a set of signaling equipment represented by a unique point code within an SS7 domain. A Local Signaling Point (LSP) is a logical element representing an SS7 Signaling Point assigned to an MP Server Group. An LSP has an SS7 domain and a true point code. The LSP may optionally be assigned up to two Capability Point Codes (CPCs), which are point codes that can be shared with other LSPs.
All configuration of Local Signaling Points is done at the SOAM.
/vstp/localsignalingpoints
get /vstp/localsignalingpoints
Returns all Local Signaling Points that meet the criteria specified in the GET request. By default, all Local Signaling Points configured at the SOAM are returned. If paging parameters are supplied, only those Local Signaling Points meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/localsignalingpointCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localsignalingpoint/localsignalingpoint.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cpcType": {
"description": "This defines the types of services or applications which are added in VSTP.",
"enum": [
"Stp",
"Eir",
"Gport",
"Inpq",
"Atinp"
],
"default": "Stp",
"type": "string"
},
"mtpPointCode": {
"description": "The MTP Point Code that identifies this LSP. Only one LSP can have this MTP Point Code.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "The name of the Local Signaling Point, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcType": {
"description": "This defines the types of point code.",
"enum": [
"Tpc",
"Spc",
"Cpc"
],
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode": {
"description": "A group may have multiple countries in it, or a country might have multiple groups in it. ITUN destinations are thus divided into groups",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default": "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"name",
"pcType",
"ss7DomainType"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "0",
"cpcType": "Stp",
"mtpPointCode": "1-1-1",
"name": "LSP1",
"pcType": "Cpc",
"ss7DomainType": "Ansi"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/localsignalingpoints
Adds a new Local Signaling Point to the VSTP configuration. The Local Signaling Point name must be unique across all Local Signaling Points at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localsignalingpoint/localsignalingpoint.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cpcType": {
"description": "This defines the types of services or applications which are added in VSTP.",
"enum": [
"Stp",
"Eir",
"Gport",
"Inpq",
"Atinp"
],
"default": "Stp",
"type": "string"
},
"mtpPointCode": {
"description": "The MTP Point Code that identifies this LSP. Only one LSP can have this MTP Point Code.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "The name of the Local Signaling Point, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcType": {
"description": "This defines the types of point code.",
"enum": [
"Tpc",
"Spc",
"Cpc"
],
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode": {
"description": "A group may have multiple countries in it, or a country might have multiple groups in it. ITUN destinations are thus divided into groups",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default": "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"name",
"pcType",
"ss7DomainType"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"cpcType": "Stp",
"mtpPointCode": "1-1-1",
"name": "LSP1",
"pcType": "Cpc",
"ss7DomainType": "Ansi"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/localsignalingpoints/{name}
get /vstp/localsignalingpoints/{name}
Returns the configuration details for the specified Local Signaling Point. If the Local Signaling Point does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/localsignalingpointItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localsignalingpoint/localsignalingpoint.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cpcType": {
"description": "This defines the types of services or applications which are added in VSTP.",
"enum": [
"Stp",
"Eir",
"Gport",
"Inpq",
"Atinp"
],
"default": "Stp",
"type": "string"
},
"mtpPointCode": {
"description": "The MTP Point Code that identifies this LSP. Only one LSP can have this MTP Point Code.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "The name of the Local Signaling Point, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcType": {
"description": "This defines the types of point code.",
"enum": [
"Tpc",
"Spc",
"Cpc"
],
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode": {
"description": "A group may have multiple countries in it, or a country might have multiple groups in it. ITUN destinations are thus divided into groups",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default": "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"name",
"pcType",
"ss7DomainType"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"cpcType": "Stp",
"mtpPointCode": "1-1-1",
"name": "LSP1",
"pcType": "Cpc",
"ss7DomainType": "Ansi"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/localsignalingpoints/{name}
Updates the configuration of the specified Local Signaling Point. If the provided Local Signaling Point data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/localsignalingpoint/localsignalingpoint.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"cpcType": {
"description": "This defines the types of services or applications which are added in VSTP.",
"enum": [
"Stp",
"Eir",
"Gport",
"Inpq",
"Atinp"
],
"default": "Stp",
"type": "string"
},
"mtpPointCode": {
"description": "The MTP Point Code that identifies this LSP. Only one LSP can have this MTP Point Code.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "The name of the Local Signaling Point, which must be unique within the DSR site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pcType": {
"description": "This defines the types of point code.",
"enum": [
"Tpc",
"Spc",
"Cpc"
],
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode": {
"description": "A group may have multiple countries in it, or a country might have multiple groups in it. ITUN destinations are thus divided into groups",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default": "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"name",
"pcType",
"ss7DomainType"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"cpcType": "Stp",
"mtpPointCode": "1-1-1",
"name": "LSP1",
"pcType": "Cpc",
"ss7DomainType": "Ansi"
}
delete /vstp/localsignalingpoints/{name}
Deletes the specified Local Signaling Point from the SOAM configuration. A Local Signaling Point can only be deleted if all delete validation checks pass. If the Local Signaling Point is part of the configuration of one or more Linksets (/vstp/linksets), the Local Signaling Point must first be removed from the Linkset (/vstp/linksets). An attempt to delete a Local Signaling Point that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: M2PA Options
The Message Transfer Part 2 (MTP2) - User Peer-to-Peer Adaptation Layer (M2PA) Options are those configuration values that govern the overall M2PA functionality. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new M2PA Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All M2PA Options configuration is done at the SOAM.
/vstp/m2paoptions
get /vstp/m2paoptions
Returns the set of current values for the M2PA Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/m2paoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m2paoption/m2paoption.json",
"properties": {
"t1Timer": {
"description": "Ready timer. The amount of time (in milliseconds) M2PA waits to receive a Link Status Ready message from the peer. Typical value is 10000.",
"maximum": 350000,
"minimum": 1000,
"type": "integer"
},
"t2Timer": {
"description": "Alignment timer. The amount of time (in milliseconds) M2PA waits to receive Link Status Alignment message from the peer. Typical value is 10000.",
"maximum": 150000,
"minimum": 5000,
"type": "integer"
},
"t3Timer": {
"description": "Proving timer. The amount of time (in milliseconds) M2PA waits to receive Link Status Proving message from the peer. Typical value is 2000.",
"maximum": 60000,
"minimum": 1000,
"type": "integer"
},
"t4EmergencyTimer": {
"description": "Emergency proving timer. The amount of time (in milliseconds) M2PA sends Link Status Proving messages during emergency proving. Typical value is 500.",
"maximum": 5000,
"minimum": 400,
"type": "integer"
},
"t4NormalTimer": {
"description": "Normal proving timer. The amount of time (in milliseconds) M2PA sends Link Status Proving messages during normal proving. Typical value is 10000.",
"maximum": 70000,
"minimum": 1000,
"type": "integer"
},
"t5Timer": {
"description": "Busy rate timer. The amount of time (in milliseconds) between sending Link Status Busy messages while the link is in service. Typical value is 100.",
"maximum": 10000,
"minimum": 100,
"type": "integer"
},
"t6Timer": {
"description": "Remote congestion timer. The amount of time (in milliseconds) that a congested link will remain in service. Typical value is 3000.",
"maximum": 6000,
"minimum": 1000,
"type": "integer"
},
"t7Timer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 1200.",
"maximum": 2000,
"minimum": 200,
"type": "integer"
},
"t16Timer": {
"description": "Proving rate timer. The amount of time (in microseconds) for which M2PA waits before sending another Link Status Proving messages to the peer and prior to expiration of t4EmergencyTimer or t4NormalTimer. Typical value is 200000.",
"maximum": 500000,
"minimum": 100,
"type": "integer"
},
"t17Timer": {
"description": "Ready rate timer. The amount of time (in milliseconds) for which M2PA waits between transmission of two consecutive Link Status Ready messages and prior to expiration of t1Timer. Typical value is 250.",
"maximum": 500,
"minimum": 100,
"type": "integer"
}
},
"required": [
"t1Timer",
"t2Timer",
"t3Timer",
"t4EmergencyTimer",
"t4NormalTimer",
"t5Timer",
"t6Timer",
"t7Timer",
"t16Timer",
"t17Timer"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"t1Timer": 1000,
"t2Timer": 5500,
"t3Timer": 1100,
"t4EmergencyTimer": 500,
"t4Timer": 1200,
"t5Timer": 300,
"t6Timer": 1400,
"t7Timer": 1500,
"t16Timer": 400,
"t17Timer": 200
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/m2paoptions
Update the M2PA Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m2paoption/m2paoption.json",
"properties": {
"t1Timer": {
"description": "Ready timer. The amount of time (in milliseconds) M2PA waits to receive a Link Status Ready message from the peer. Typical value is 10000.",
"maximum": 350000,
"minimum": 1000,
"type": "integer"
},
"t2Timer": {
"description": "Alignment timer. The amount of time (in milliseconds) M2PA waits to receive Link Status Alignment message from the peer. Typical value is 10000.",
"maximum": 150000,
"minimum": 5000,
"type": "integer"
},
"t3Timer": {
"description": "Proving timer. The amount of time (in milliseconds) M2PA waits to receive Link Status Proving message from the peer. Typical value is 2000.",
"maximum": 60000,
"minimum": 1000,
"type": "integer"
},
"t4EmergencyTimer": {
"description": "Emergency proving timer. The amount of time (in milliseconds) M2PA sends Link Status Proving messages during emergency proving. Typical value is 500.",
"maximum": 5000,
"minimum": 400,
"type": "integer"
},
"t4NormalTimer": {
"description": "Normal proving timer. The amount of time (in milliseconds) M2PA sends Link Status Proving messages during normal proving. Typical value is 10000.",
"maximum": 70000,
"minimum": 1000,
"type": "integer"
},
"t5Timer": {
"description": "Busy rate timer. The amount of time (in milliseconds) between sending Link Status Busy messages while the link is in service. Typical value is 100.",
"maximum": 10000,
"minimum": 100,
"type": "integer"
},
"t6Timer": {
"description": "Remote congestion timer. The amount of time (in milliseconds) that a congested link will remain in service. Typical value is 3000.",
"maximum": 6000,
"minimum": 1000,
"type": "integer"
},
"t7Timer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 1200.",
"maximum": 2000,
"minimum": 200,
"type": "integer"
},
"t16Timer": {
"description": "Proving rate timer. The amount of time (in microseconds) for which M2PA waits before sending another Link Status Proving messages to the peer and prior to expiration of t4EmergencyTimer or t4NormalTimer. Typical value is 200000.",
"maximum": 500000,
"minimum": 100,
"type": "integer"
},
"t17Timer": {
"description": "Ready rate timer. The amount of time (in milliseconds) for which M2PA waits between transmission of two consecutive Link Status Ready messages and prior to expiration of t1Timer. Typical value is 250.",
"maximum": 500,
"minimum": 100,
"type": "integer"
}
},
"required": [
"t1Timer",
"t2Timer",
"t3Timer",
"t4EmergencyTimer",
"t4NormalTimer",
"t5Timer",
"t6Timer",
"t7Timer",
"t16Timer",
"t17Timer"
],
"type": "object"
}
Example
{
"t1Timer": 1000,
"t2Timer": 5500,
"t3Timer": 1100,
"t4EmergencyTimer": 500,
"t4Timer": 1200,
"t5Timer": 300,
"t6Timer": 1400,
"t7Timer": 1500,
"t16Timer": 400,
"t17Timer": 200
}
Vstp: Mtp3 Timer Set Configs
A Mtp3 Config is an entity to configure all the m3rl timers.
All configuration of Mtp3 Config is done at the SOAM. To support 20K MPS traffic rate per vSTP MP, the CO/CB timers - "t1Timer", "t2Timer", "t3Timer" , "t4Timer" and "t5Timer" - values in the above MO should be configured to half of default value i.e. should be set to "400 msec" instead of "800 msec".
/vstp/mtp3timersetconfigs
get /vstp/mtp3timersetconfigs
Returns all Mtp3 Configs that meet the criteria specified in the GET request. By default, all Mtp3 Configs configured at the SOAM are returned. If paging parameters are supplied, only those Mtp3 Configs meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mtp3configCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp3config/mtp3config.json",
"properties": {
"lsOnHoldTimer": {
"description": "Link addition/deletion changeover timer duration. This timer introduces a delay to help prevent message mis-sequencing on link add/deletion. Typical value is 60.",
"type": "integer",
"minimum": 10,
"maximum": 2000
},
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sltT1Timer": {
"description": "Supervision timer for signaling link test acknowledgement message. Typical value is 12000.",
"type": "integer",
"minimum": 4000,
"maximum": 12000
},
"sltT2Timer": {
"description": "Interval timer for sending signaling link test messages. Typical value is 30000.",
"type": "integer",
"minimum": 30000,
"maximum": 90000
},
"sltT17Timer": {
"description": "SLT T17 timer set. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t10Timer": {
"description": "Timer 10 - Wait to repeat signaling route set test (SRST) message. Typical value is 30000.",
"type": "integer",
"minimum": 20000,
"maximum": 90000
},
"t11Timer": {
"description": "Timer 11 - Transfer restricted; in milliseconds. Typical value is 30000.",
"type": "integer",
"minimum": 1000,
"maximum": 90000
},
"t12Timer": {
"description": "Timer 12 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t13Timer": {
"description": "Timer 13 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t15Timer": {
"description": "Timer 15 - Wait for repeat route set congestion test (RSCT). Typical value is 3000.",
"type": "integer",
"minimum": 200,
"maximum": 4000
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 1400.",
"type": "integer",
"minimum": 200,
"maximum": 3000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t18Timer": {
"description": "Timer 18 - Repeat transfer restricted (TFR) once by response method. Typical value is 10000.",
"type": "integer",
"minimum": 2000,
"maximum": 20000
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t23Timer": {
"description": "Timer 23 - Linkset inhibited; in milliseconds. Typical value is 180000.",
"type": "integer",
"minimum": 180000,
"maximum": 360000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 1400.",
"type": "integer",
"minimum": 100,
"maximum": 3000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t4Timer": {
"description": "Timer 4 - Wait for changeback acknowledgement (CBA) #1. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t8Timer": {
"description": "Timer 8 - Transfer prohibited (TFP) inhibit. Typical value is 800.",
"type": "integer",
"minimum": 500,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "config1",
"lsOnHoldTimer": 200,
"sltT1Timer": 8000,
"sltT2Timer": 35000,
"sltT17Timer": 2000,
"t10Timer": 25000,
"t11Timer": 3000,
"t12Timer": 800,
"t13Timer": 800,
"t15Timer": 600,
"t16Timer": 800,
"t17Timer": 800,
"t18Timer": 3000,
"t1Timer": 800,
"t2Timer": 800,
"t23Timer": 180000,
"t3Timer": 800,
"t4Timer": 600,
"t5Timer": 600,
"t6Timer": 800,
"t8Timer": 800
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/mtp3timersetconfigs
Adds a new Mtp3 Config to the VSTP configuration. If the provided Mtp3 Config data is invalid in any way, the insert fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp3config/mtp3config.json",
"properties": {
"lsOnHoldTimer": {
"description": "Link addition/deletion changeover timer duration. This timer introduces a delay to help prevent message mis-sequencing on link add/deletion. Typical value is 60.",
"type": "integer",
"minimum": 10,
"maximum": 2000
},
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sltT1Timer": {
"description": "Supervision timer for signaling link test acknowledgement message. Typical value is 12000.",
"type": "integer",
"minimum": 4000,
"maximum": 12000
},
"sltT2Timer": {
"description": "Interval timer for sending signaling link test messages. Typical value is 30000.",
"type": "integer",
"minimum": 30000,
"maximum": 90000
},
"sltT17Timer": {
"description": "SLT T17 timer set. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t10Timer": {
"description": "Timer 10 - Wait to repeat signaling route set test (SRST) message. Typical value is 30000.",
"type": "integer",
"minimum": 20000,
"maximum": 90000
},
"t11Timer": {
"description": "Timer 11 - Transfer restricted; in milliseconds. Typical value is 30000.",
"type": "integer",
"minimum": 1000,
"maximum": 90000
},
"t12Timer": {
"description": "Timer 12 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t13Timer": {
"description": "Timer 13 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t15Timer": {
"description": "Timer 15 - Wait for repeat route set congestion test (RSCT). Typical value is 3000.",
"type": "integer",
"minimum": 200,
"maximum": 4000
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 1400.",
"type": "integer",
"minimum": 200,
"maximum": 3000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t18Timer": {
"description": "Timer 18 - Repeat transfer restricted (TFR) once by response method. Typical value is 10000.",
"type": "integer",
"minimum": 2000,
"maximum": 20000
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t23Timer": {
"description": "Timer 23 - Linkset inhibited; in milliseconds. Typical value is 180000.",
"type": "integer",
"minimum": 180000,
"maximum": 360000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 1400.",
"type": "integer",
"minimum": 100,
"maximum": 3000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t4Timer": {
"description": "Timer 4 - Wait for changeback acknowledgement (CBA) #1. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t8Timer": {
"description": "Timer 8 - Transfer prohibited (TFP) inhibit. Typical value is 800.",
"type": "integer",
"minimum": 500,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "config1",
"lsOnHoldTimer": 200,
"sltT1Timer": 8000,
"sltT2Timer": 35000,
"sltT17Timer": 2000,
"t10Timer": 25000,
"t11Timer": 3000,
"t12Timer": 800,
"t13Timer": 800,
"t15Timer": 600,
"t16Timer": 800,
"t17Timer": 800,
"t18Timer": 3000,
"t1Timer": 800,
"t2Timer": 800,
"t23Timer": 180000,
"t3Timer": 800,
"t4Timer": 600,
"t5Timer": 600,
"t6Timer": 800,
"t8Timer": 800
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/mtp3timersetconfigs/{name}
get /vstp/mtp3timersetconfigs/{name}
Returns the configuration details for the specified Mtp3 Config. If the Mtp3 Config does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mtp3configItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp3config/mtp3config.json",
"properties": {
"lsOnHoldTimer": {
"description": "Link addition/deletion changeover timer duration. This timer introduces a delay to help prevent message mis-sequencing on link add/deletion. Typical value is 60.",
"type": "integer",
"minimum": 10,
"maximum": 2000
},
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sltT1Timer": {
"description": "Supervision timer for signaling link test acknowledgement message. Typical value is 12000.",
"type": "integer",
"minimum": 4000,
"maximum": 12000
},
"sltT2Timer": {
"description": "Interval timer for sending signaling link test messages. Typical value is 30000.",
"type": "integer",
"minimum": 30000,
"maximum": 90000
},
"sltT17Timer": {
"description": "SLT T17 timer set. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t10Timer": {
"description": "Timer 10 - Wait to repeat signaling route set test (SRST) message. Typical value is 30000.",
"type": "integer",
"minimum": 20000,
"maximum": 90000
},
"t11Timer": {
"description": "Timer 11 - Transfer restricted; in milliseconds. Typical value is 30000.",
"type": "integer",
"minimum": 1000,
"maximum": 90000
},
"t12Timer": {
"description": "Timer 12 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t13Timer": {
"description": "Timer 13 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t15Timer": {
"description": "Timer 15 - Wait for repeat route set congestion test (RSCT). Typical value is 3000.",
"type": "integer",
"minimum": 200,
"maximum": 4000
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 1400.",
"type": "integer",
"minimum": 200,
"maximum": 3000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t18Timer": {
"description": "Timer 18 - Repeat transfer restricted (TFR) once by response method. Typical value is 10000.",
"type": "integer",
"minimum": 2000,
"maximum": 20000
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t23Timer": {
"description": "Timer 23 - Linkset inhibited; in milliseconds. Typical value is 180000.",
"type": "integer",
"minimum": 180000,
"maximum": 360000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 1400.",
"type": "integer",
"minimum": 100,
"maximum": 3000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t4Timer": {
"description": "Timer 4 - Wait for changeback acknowledgement (CBA) #1. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t8Timer": {
"description": "Timer 8 - Transfer prohibited (TFP) inhibit. Typical value is 800.",
"type": "integer",
"minimum": 500,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "config1",
"lsOnHoldTimer": 200,
"sltT1Timer": 8000,
"sltT2Timer": 35000,
"sltT17Timer": 2000,
"t10Timer": 25000,
"t11Timer": 3000,
"t12Timer": 800,
"t13Timer": 800,
"t15Timer": 600,
"t16Timer": 800,
"t17Timer": 800,
"t18Timer": 3000,
"t1Timer": 800,
"t2Timer": 800,
"t23Timer": 180000,
"t3Timer": 800,
"t4Timer": 600,
"t5Timer": 600,
"t6Timer": 800,
"t8Timer": 800
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/mtp3timersetconfigs/{name}
Updates the configuration of the specified Mtp3 Config. If the provided Mtp3 Config data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp3config/mtp3config.json",
"properties": {
"lsOnHoldTimer": {
"description": "Link addition/deletion changeover timer duration. This timer introduces a delay to help prevent message mis-sequencing on link add/deletion. Typical value is 60.",
"type": "integer",
"minimum": 10,
"maximum": 2000
},
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"sltT1Timer": {
"description": "Supervision timer for signaling link test acknowledgement message. Typical value is 12000.",
"type": "integer",
"minimum": 4000,
"maximum": 12000
},
"sltT2Timer": {
"description": "Interval timer for sending signaling link test messages. Typical value is 30000.",
"type": "integer",
"minimum": 30000,
"maximum": 90000
},
"sltT17Timer": {
"description": "SLT T17 timer set. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t10Timer": {
"description": "Timer 10 - Wait to repeat signaling route set test (SRST) message. Typical value is 30000.",
"type": "integer",
"minimum": 20000,
"maximum": 90000
},
"t11Timer": {
"description": "Timer 11 - Transfer restricted; in milliseconds. Typical value is 30000.",
"type": "integer",
"minimum": 1000,
"maximum": 90000
},
"t12Timer": {
"description": "Timer 12 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t13Timer": {
"description": "Timer 13 - Linkset inhibited; in milliseconds. Typical value is 800.",
"type": "integer",
"minimum": 800,
"maximum": 1500
},
"t15Timer": {
"description": "Timer 15 - Wait for repeat route set congestion test (RSCT). Typical value is 3000.",
"type": "integer",
"minimum": 200,
"maximum": 4000
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 1400.",
"type": "integer",
"minimum": 200,
"maximum": 3000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 2000.",
"type": "integer",
"minimum": 500,
"maximum": 2000
},
"t18Timer": {
"description": "Timer 18 - Repeat transfer restricted (TFR) once by response method. Typical value is 10000.",
"type": "integer",
"minimum": 2000,
"maximum": 20000
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t23Timer": {
"description": "Timer 23 - Linkset inhibited; in milliseconds. Typical value is 180000.",
"type": "integer",
"minimum": 180000,
"maximum": 360000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 1400.",
"type": "integer",
"minimum": 100,
"maximum": 3000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t4Timer": {
"description": "Timer 4 - Wait for changeback acknowledgement (CBA) #1. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 800.",
"type": "integer",
"minimum": 100,
"maximum": 2000
},
"t8Timer": {
"description": "Timer 8 - Transfer prohibited (TFP) inhibit. Typical value is 800.",
"type": "integer",
"minimum": 500,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "config1",
"lsOnHoldTimer": 200,
"sltT1Timer": 8000,
"sltT2Timer": 35000,
"sltT17Timer": 2000,
"t10Timer": 25000,
"t11Timer": 3000,
"t12Timer": 800,
"t13Timer": 800,
"t15Timer": 600,
"t16Timer": 800,
"t17Timer": 800,
"t18Timer": 3000,
"t1Timer": 800,
"t2Timer": 800,
"t23Timer": 180000,
"t3Timer": 800,
"t4Timer": 600,
"t5Timer": 600,
"t6Timer": 800,
"t8Timer": 800
}
delete /vstp/mtp3timersetconfigs/{name}
Deletes the specified Mtp3 Config from the SOAM configuration. A Mtp3 Config can only be deleted if all delete validation checks pass. In general, An attempt to delete a Mtp3 Config that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: M3ua Timer Set Configs
A M3ua Config is an entity to configure all the m3ua timers.
All configuration of M3ua Config is done at the SOAM.
/vstp/m3uatimersetconfigs
get /vstp/m3uatimersetconfigs
Returns all M3ua Configs that meet the criteria specified in the GET request. By default, all M3ua Configs configured at the SOAM are returned. If paging parameters are supplied, only those M3ua Configs meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/m3uaconfigCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"aspActAckTimer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 500.",
"maximum": 10000,
"minimum": 500,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "m3uaConf1",
"aspActAckTimer": 600
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/m3uatimersetconfigs
Adds a new M3ua Config to the VSTP configuration. If the provided M3ua Config data is invalid in any way, the insert fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"aspActAckTimer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 500.",
"maximum": 10000,
"minimum": 500,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "m3uaConf1",
"aspActAckTimer": 600
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/m3uatimersetconfigs/{name}
get /vstp/m3uatimersetconfigs/{name}
Returns the configuration details for the specified M3ua Config. If the M3ua Config does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/m3uaconfigItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"aspActAckTimer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 500.",
"maximum": 10000,
"minimum": 500,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "m3uaConf1",
"aspActAckTimer": 600
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/m3uatimersetconfigs/{name}
Updates the configuration of the specified M3ua Config. If the provided M3ua Config data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"aspActAckTimer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 500.",
"maximum": 10000,
"minimum": 500,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "m3uaConf1",
"aspActAckTimer": 600
}
delete /vstp/m3uatimersetconfigs/{name}
Deletes the specified M3ua Config from the SOAM configuration. A M3ua Config can only be deleted if all delete validation checks pass. In general, An attempt to delete a M3ua Config that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: M2pa Timer Set Configs
A M2pa Config is an entity to configure all the m2pa timers.
All configuration of M2pa is done at the SOAM.
/vstp/m2patimersetconfigs
get /vstp/m2patimersetconfigs
Returns all M2pa timer that meet the criteria specified in the GET request. By default, all M2pa timer configured at the SOAM are returned. If paging parameters are supplied, only those M2pa timers meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/m2paconfigCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m3rlconfig/m3rlconfig.json",
"properties": {
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 200000.",
"type": "integer",
"default": 200000,
"minimum": 100,
"maximum": 500000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 250.",
"type": "integer",
"default": 250,
"minimum": 100,
"maximum": 500
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 350000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 5000,
"maximum": 15000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 60000
},
"t4EmergencyTimer": {
"description": "Timer 4 - Emergency Proving Timer. Typical value is 500.",
"type": "integer",
"default": 500,
"minimum": 400,
"maximum": 5000
},
"t4NormalTimer": {
"description": "Timer 4 - Normal Proving Timer. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 70000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 100.",
"type": "integer",
"default": 1000,
"minimum": 80,
"maximum": 10000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 3000.",
"type": "integer",
"default": 3000,
"minimum": 1000,
"maximum": 6000
},
"t7Timer": {
"description": "Timer 7 - Excessive acknowledgement delay timer. Typical value is 1200.",
"type": "integer",
"default": 1200,
"minimum": 200,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "config1",
"t16Timer": 200000,
"t17Timer": 250,
"t1Timer": 100000,
"t2Timer": 100000,
"t3Timer": 2000,
"t4EmergencyTimer": 500,
"t4NormalTimer": 10000,
"t5Timer": 100,
"t6Timer": 3000,
"t7Timer": 1200
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/m2patimersetconfigs
Adds a new M2pa timer to the VSTP configuration. The M2pa name must be unique as it refers to the Service name at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m3rlconfig/m3rlconfig.json",
"properties": {
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 200000.",
"type": "integer",
"default": 200000,
"minimum": 100,
"maximum": 500000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 250.",
"type": "integer",
"default": 250,
"minimum": 100,
"maximum": 500
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 350000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 5000,
"maximum": 15000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 60000
},
"t4EmergencyTimer": {
"description": "Timer 4 - Emergency Proving Timer. Typical value is 500.",
"type": "integer",
"default": 500,
"minimum": 400,
"maximum": 5000
},
"t4NormalTimer": {
"description": "Timer 4 - Normal Proving Timer. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 70000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 100.",
"type": "integer",
"default": 1000,
"minimum": 80,
"maximum": 10000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 3000.",
"type": "integer",
"default": 3000,
"minimum": 1000,
"maximum": 6000
},
"t7Timer": {
"description": "Timer 7 - Excessive acknowledgement delay timer. Typical value is 1200.",
"type": "integer",
"default": 1200,
"minimum": 200,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "config1",
"t16Timer": 200000,
"t17Timer": 250,
"t1Timer": 100000,
"t2Timer": 100000,
"t3Timer": 2000,
"t4EmergencyTimer": 500,
"t4NormalTimer": 10000,
"t5Timer": 100,
"t6Timer": 3000,
"t7Timer": 1200
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/m2patimersetconfigs/{name}
get /vstp/m2patimersetconfigs/{name}
Returns the configuration details for the specified M2pa. If the M2pa Name does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/m2paconfigItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m3rlconfig/m3rlconfig.json",
"properties": {
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 200000.",
"type": "integer",
"default": 200000,
"minimum": 100,
"maximum": 500000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 250.",
"type": "integer",
"default": 250,
"minimum": 100,
"maximum": 500
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 350000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 5000,
"maximum": 15000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 60000
},
"t4EmergencyTimer": {
"description": "Timer 4 - Emergency Proving Timer. Typical value is 500.",
"type": "integer",
"default": 500,
"minimum": 400,
"maximum": 5000
},
"t4NormalTimer": {
"description": "Timer 4 - Normal Proving Timer. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 70000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 100.",
"type": "integer",
"default": 1000,
"minimum": 80,
"maximum": 10000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 3000.",
"type": "integer",
"default": 3000,
"minimum": 1000,
"maximum": 6000
},
"t7Timer": {
"description": "Timer 7 - Excessive acknowledgement delay timer. Typical value is 1200.",
"type": "integer",
"default": 1200,
"minimum": 200,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "config1",
"t16Timer": 200000,
"t17Timer": 250,
"t1Timer": 100000,
"t2Timer": 100000,
"t3Timer": 2000,
"t4EmergencyTimer": 500,
"t4NormalTimer": 10000,
"t5Timer": 100,
"t6Timer": 3000,
"t7Timer": 1200
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/m2patimersetconfigs/{name}
Updates the configuration of the specified M2pa. If the provided M2pa data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m3rlconfig/m3rlconfig.json",
"properties": {
"name": {
"description": "Name for this M3rl Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t16Timer": {
"description": "Timer 16 - Wait for route set congestion test (RSCT) updates. Typical value is 200000.",
"type": "integer",
"default": 200000,
"minimum": 100,
"maximum": 500000
},
"t17Timer": {
"description": "Timer 17 - Delay to avoid oscillation of initial alignment failure. Typical value is 250.",
"type": "integer",
"default": 250,
"minimum": 100,
"maximum": 500
},
"t1Timer": {
"description": "Timer 1 - Changeover delay. Also used as isolation timer for ITU MTP Restart. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 350000
},
"t2Timer": {
"description": "Timer 2 - Wait for changeover acknowledgement (COA). Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 5000,
"maximum": 15000
},
"t3Timer": {
"description": "Timer 3 - Time controlled diversion on changeback. Typical value is 2000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 60000
},
"t4EmergencyTimer": {
"description": "Timer 4 - Emergency Proving Timer. Typical value is 500.",
"type": "integer",
"default": 500,
"minimum": 400,
"maximum": 5000
},
"t4NormalTimer": {
"description": "Timer 4 - Normal Proving Timer. Typical value is 10000.",
"type": "integer",
"default": 10000,
"minimum": 1000,
"maximum": 70000
},
"t5Timer": {
"description": "Timer 5 - Wait for changeback acknowledgement (CBA) #2. Typical value is 100.",
"type": "integer",
"default": 1000,
"minimum": 80,
"maximum": 10000
},
"t6Timer": {
"description": "Timer 6 - Controlled reroute. Typical value is 3000.",
"type": "integer",
"default": 3000,
"minimum": 1000,
"maximum": 6000
},
"t7Timer": {
"description": "Timer 7 - Excessive acknowledgement delay timer. Typical value is 1200.",
"type": "integer",
"default": 1200,
"minimum": 200,
"maximum": 2000
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "config1",
"t16Timer": 200000,
"t17Timer": 250,
"t1Timer": 100000,
"t2Timer": 100000,
"t3Timer": 2000,
"t4EmergencyTimer": 500,
"t4NormalTimer": 10000,
"t5Timer": 100,
"t6Timer": 3000,
"t7Timer": 1200
}
delete /vstp/m2patimersetconfigs/{name}
Deletes the specified M2pa from the SOAM configuration. A M2pa data can only be deleted if all delete validation checks pass. In general, if the M2pa is associated with a linkset , the M2pa cannot be deleted. An attempt to delete a M2pa that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: MTP3 Options
The Message Transfer Part level 3 (MTP3) Options are configuration values that govern the overall MTP3 functionality. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected. Because there is no collection of instances, there is no collection GET action. No new MTP3 Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action.
All MTP3 Options configuration is done at the SOAM.
/vstp/m3rloptions
get /vstp/m3rloptions
Returns the set of current values for the MTP3 Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/m3rloptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m3rloption/m3rloption.json",
"properties": {
"cnvAInat": {
"description": "This parameter sets the value of the called party/calling party address Reserved for National Use bit when the message is routed to the ITU national network.",
"default": 1,
"maximum": 1,
"minimum": 0,
"type": "integer"
},
"cnvCgda": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Ansi, and the point code or alias point code of the destination network type is not defined.",
"default": false,
"type": "boolean"
},
"cnvCgdi": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Itui, and the point code or alias point code of the destination network type is not defined",
"default": false,
"type": "boolean"
},
"cnvCgdn": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Itun, and the point code or alias point code of the destination network type is not defined",
"default": false,
"type": "boolean"
},
"cnvCgdn24": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Itun24, and the point code or alias point code of the destination network type is not defined",
"default": false,
"type": "boolean"
},
"cnvClgItu": {
"description": "This parameter enables or disables the CGPA conversion for Itui/Itui_s/Itun/Itun_s domain crossing during SCCP conversion.",
"enum": [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"gtCnvDflt": {
"description": "This parameter enables routing of SCCP messages using system defaults when an appropriate entry is not found in the Default GT Conversion Table",
"default": false,
"type": "boolean"
},
"islsbrEnabled": {
"description": "This parameter indicates whether an Incomig SLS Bit Rotation is enabled or not.If it is turned on and Incoming SLS Bit Rotation is applied to an MSU then the outgoing SLS bit rotation is not applied for that MSU",
"default":false,
"type": "boolean"
},
"randsls": {
"description": "Random SLS (signaling link selection).This parameter is used to apply random SLS generation on a per linkset basis.",
"enum": [
"Off",
"All",
"Class0",
"PerLs"
],
"default": "Off",
"type": "string"
},
"slsRotation": {
"description": "This parameter specifies whether the signaling link selector (SLS) of the incoming ANSI linkset is rotated before routing the messages to network. When set to true, 8 bit SLS of the incoming linkset is considered for bit rotation.",
"type": "boolean"
},
"slscnv": {
"description": "This parameter is used as Per node SLS conversion indicator.",
"enum": [
"On",
"Off",
"PerLs"
],
"default": "Off",
"type": "string"
},
"slsreplace": {
"description": "This parameter allows to replace the SLS for an ANSI message with a random generated SLS value by Random SLS feature",
"default":false,
"type": "boolean"
},
"slsocbEnabled": {
"description": "This parameter turns on the Other CIC (Circuit Identification Code) Bit Used feature",
"default":false,
"type": "boolean"
},
"sparePCSupportEnabled":{
"description": "Checks whether the support for ITUN-Spare and ITUI-Spare is enabled or disabled",
"type": "boolean",
"default": "true"
},
"performanceMeasurement": {
"description": "This parameter is used for turning on/off the performance counter measurements. If turned on, it will start updating timing data on various layers.",
"enum": [
"On",
"Off"
],
"default": "Off",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"cnvAInat": 1,
"cnvCgda": false,
"cnvCgdi": false,
"cnvCgdn": false,
"cnvCgdn24": false,
"cnvCgdn16": false,
"gtCnvDflt": false,
"cnvClgItu": "Off",
"randsls":"Off",
"slsRotation": false,
"slscnv":"Off",
"slsreplace": false,
"slsocbEnabled": false,
"islsbrEnabled": false,
"sparePCSupportEnabled": false
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/m3rloptions
Update the MTP3 Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, and PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/m3rloption/m3rloption.json",
"properties": {
"cnvAInat": {
"description": "This parameter sets the value of the called party/calling party address Reserved for National Use bit when the message is routed to the ITU national network.",
"default": 1,
"maximum": 1,
"minimum": 0,
"type": "integer"
},
"cnvCgda": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Ansi, and the point code or alias point code of the destination network type is not defined.",
"default": false,
"type": "boolean"
},
"cnvCgdi": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Itui, and the point code or alias point code of the destination network type is not defined",
"default": false,
"type": "boolean"
},
"cnvCgdn": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Itun, and the point code or alias point code of the destination network type is not defined",
"default": false,
"type": "boolean"
},
"cnvCgdn24": {
"description": "This parameter enables discarding of the CGPA point code in SCCP messages if the destination network type is Itun24, and the point code or alias point code of the destination network type is not defined",
"default": false,
"type": "boolean"
},
"cnvClgItu": {
"description": "This parameter enables or disables the CGPA conversion for Itui/Itui_s/Itun/Itun_s domain crossing during SCCP conversion.",
"enum": [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"gtCnvDflt": {
"description": "This parameter enables routing of SCCP messages using system defaults when an appropriate entry is not found in the Default GT Conversion Table",
"default": false,
"type": "boolean"
},
"islsbrEnabled": {
"description": "This parameter indicates whether an Incomig SLS Bit Rotation is enabled or not.If it is turned on and Incoming SLS Bit Rotation is applied to an MSU then the outgoing SLS bit rotation is not applied for that MSU",
"default":false,
"type": "boolean"
},
"randsls": {
"description": "Random SLS (signaling link selection).This parameter is used to apply random SLS generation on a per linkset basis.",
"enum": [
"Off",
"All",
"Class0",
"PerLs"
],
"default": "Off",
"type": "string"
},
"slsRotation": {
"description": "This parameter specifies whether the signaling link selector (SLS) of the incoming ANSI linkset is rotated before routing the messages to network. When set to true, 8 bit SLS of the incoming linkset is considered for bit rotation.",
"type": "boolean"
},
"slscnv": {
"description": "This parameter is used as Per node SLS conversion indicator.",
"enum": [
"On",
"Off",
"PerLs"
],
"default": "Off",
"type": "string"
},
"slsreplace": {
"description": "This parameter allows to replace the SLS for an ANSI message with a random generated SLS value by Random SLS feature",
"default":false,
"type": "boolean"
},
"slsocbEnabled": {
"description": "This parameter turns on the Other CIC (Circuit Identification Code) Bit Used feature",
"default":false,
"type": "boolean"
},
"sparePCSupportEnabled":{
"description": "Checks whether the support for ITUN-Spare and ITUI-Spare is enabled or disabled",
"type": "boolean",
"default": "true"
},
"performanceMeasurement": {
"description": "This parameter is used for turning on/off the performance counter measurements. If turned on, it will start updating timing data on various layers.",
"enum": [
"On",
"Off"
],
"default": "Off",
"type": "string"
}
},
"type": "object"
}
Example
{
"cnvAInat": 1,
"cnvCgda": false,
"cnvCgdi": false,
"cnvCgdn": false,
"cnvCgdn24": false,
"cnvCgdn16": false,
"gtCnvDflt": false,
"cnvClgItu": "Off",
"randsls":"Off",
"slsRotation": false,
"slscnv":"Off",
"slsreplace": false,
"slsocbEnabled": false,
"islsbrEnabled": false,
"sparePCSupportEnabled": false
}
Vstp: MAP Sets
A Mated Application Part (MAP) Set is a logical grouping of Remote Signaling Points (/vstp/remotesignalingpoints) referred to as a load sharing group. The Default MAP Set (the MAP Set with mapSetId equal to 0) can have multiple load sharing groups. All other MAP Sets can have only one load sharing group associated with them. A load sharing group can have at most 32 RSPs.
All configuration of MAP Sets is done at the SOAM.
/vstp/mapsets
get /vstp/mapsets
Returns all MAP Sets that meet the criteria specified in the GET request. By default, all MAP Sets configured at the SOAM are returned. If paging parameters are supplied, only those MAP Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mapsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mapset/mapset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MAP Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Id of this MAP Set. mapSetId can be any integer in the allowable range, and must be unique across MAP Sets. If a mate RSP (/vstp/remotesignalingpoints) is being added to an existing MAP Set, the mapSetId must be the same as assigned to the MAP Set instance containing the primary RSP.",
"maximum": 36000,
"minimum": 1,
"type": "integer"
},
"messageRouteCongestion": {
"description": "Must be set to Yes if the Class 0 messages to the specified RSP (/vstp/remotesignalingpoints) can be routed to the next preferred node/subsystem when that RSP is congested. No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for messageRouteCongestion is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MAP Set. For the primary RSP, the default value is 10 and for a mate RSP the default value is 50.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"ssn": {
"description": "Defines the application's subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"subsystemRoutingMessage": {
"description": "Must be set to Yes if the subsystem routing messages (SBR, SNR) are transmitted between the mated applications, No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for subsystemRoutingMessage is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"subsystemStatusOption": {
"description": "Must be set to Yes if the RSP (/vstp/remotesignalingpoints) specified by rspName initiates a subsystem test when a RESUME message is received, No otherwise. Default is equivalent to No. If not specified by user the value for subsystemStatusOption is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold assigned to each combination of RSP (/vstp/remotesignalingpoints) and SSN in this MAP Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If this parameter is not specified, a value of 1% is assigned to each RSP in this MAP Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAP Set. The unique identifier value is a combination of mapSetId, ssn and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-2-Rsp1, where 3 is the MAP Set Id, 2 is the ssn and Rsp1 is the RSP (/vstp/remotesignalingpoints) name.",
"readOnly": true,
"pattern": "^([0-9]*)(-)([0-9]*)(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the primary RSP (/vstp/remotesignalingpoints) of this MAP Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mapSetId",
"relativeCost",
"rspName",
"ssn"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "1",
"rspName": "Rsp1",
"mapSetId": 1,
"messageRouteCongestion": "No",
"relativeCost": 1,
"ssn": 2,
"subsystemRoutingMessage": "No",
"subsystemStatusOption": "No",
"threshold": 1,
"uniqueIdentifier": "1-2-Rsp1",
"weight": 1
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/mapsets
Adds a new MAP Set entry to the vSTP configuration. The combination of mapSetId, rspName and ssn must be unique across all MAP Set entries at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mapset/mapset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MAP Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Id of this MAP Set. mapSetId can be any integer in the allowable range, and must be unique across MAP Sets. If a mate RSP (/vstp/remotesignalingpoints) is being added to an existing MAP Set, the mapSetId must be the same as assigned to the MAP Set instance containing the primary RSP.",
"maximum": 36000,
"minimum": 1,
"type": "integer"
},
"messageRouteCongestion": {
"description": "Must be set to Yes if the Class 0 messages to the specified RSP (/vstp/remotesignalingpoints) can be routed to the next preferred node/subsystem when that RSP is congested. No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for messageRouteCongestion is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MAP Set. For the primary RSP, the default value is 10 and for a mate RSP the default value is 50.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"ssn": {
"description": "Defines the application's subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"subsystemRoutingMessage": {
"description": "Must be set to Yes if the subsystem routing messages (SBR, SNR) are transmitted between the mated applications, No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for subsystemRoutingMessage is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"subsystemStatusOption": {
"description": "Must be set to Yes if the RSP (/vstp/remotesignalingpoints) specified by rspName initiates a subsystem test when a RESUME message is received, No otherwise. Default is equivalent to No. If not specified by user the value for subsystemStatusOption is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold assigned to each combination of RSP (/vstp/remotesignalingpoints) and SSN in this MAP Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If this parameter is not specified, a value of 1% is assigned to each RSP in this MAP Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAP Set. The unique identifier value is a combination of mapSetId, ssn and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-2-Rsp1, where 3 is the MAP Set Id, 2 is the ssn and Rsp1 is the RSP (/vstp/remotesignalingpoints) name.",
"readOnly": true,
"pattern": "^([0-9]*)(-)([0-9]*)(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the primary RSP (/vstp/remotesignalingpoints) of this MAP Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mapSetId",
"relativeCost",
"rspName",
"ssn"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"rspName": "Rsp1",
"mapSetId": 1,
"messageRouteCongestion": "No",
"relativeCost": 1,
"ssn": 2,
"subsystemRoutingMessage": "No",
"subsystemStatusOption": "No",
"threshold": 1,
"uniqueIdentifier": "1-2-Rsp1",
"weight": 1
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/mapsets/{uniqueIdentifier}
get /vstp/mapsets/{uniqueIdentifier}
Returns the configuration details for the specified MAP Set. If the MAP Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mapsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mapset/mapset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MAP Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Id of this MAP Set. mapSetId can be any integer in the allowable range, and must be unique across MAP Sets. If a mate RSP (/vstp/remotesignalingpoints) is being added to an existing MAP Set, the mapSetId must be the same as assigned to the MAP Set instance containing the primary RSP.",
"maximum": 36000,
"minimum": 1,
"type": "integer"
},
"messageRouteCongestion": {
"description": "Must be set to Yes if the Class 0 messages to the specified RSP (/vstp/remotesignalingpoints) can be routed to the next preferred node/subsystem when that RSP is congested. No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for messageRouteCongestion is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MAP Set. For the primary RSP, the default value is 10 and for a mate RSP the default value is 50.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"ssn": {
"description": "Defines the application's subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"subsystemRoutingMessage": {
"description": "Must be set to Yes if the subsystem routing messages (SBR, SNR) are transmitted between the mated applications, No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for subsystemRoutingMessage is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"subsystemStatusOption": {
"description": "Must be set to Yes if the RSP (/vstp/remotesignalingpoints) specified by rspName initiates a subsystem test when a RESUME message is received, No otherwise. Default is equivalent to No. If not specified by user the value for subsystemStatusOption is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold assigned to each combination of RSP (/vstp/remotesignalingpoints) and SSN in this MAP Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If this parameter is not specified, a value of 1% is assigned to each RSP in this MAP Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAP Set. The unique identifier value is a combination of mapSetId, ssn and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-2-Rsp1, where 3 is the MAP Set Id, 2 is the ssn and Rsp1 is the RSP (/vstp/remotesignalingpoints) name.",
"readOnly": true,
"pattern": "^([0-9]*)(-)([0-9]*)(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the primary RSP (/vstp/remotesignalingpoints) of this MAP Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mapSetId",
"relativeCost",
"rspName",
"ssn"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "1",
"rspName": "Rsp1",
"mapSetId": 1,
"messageRouteCongestion": "No",
"relativeCost": 1,
"ssn": 2,
"subsystemRoutingMessage": "No",
"subsystemStatusOption": "No",
"threshold": 1,
"uniqueIdentifier": "1-2-Rsp1",
"weight": 1
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/mapsets/{uniqueIdentifier}
Updates the configuration of the specified MAP Set. If the provided MAP Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mapset/mapset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MAP Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"mapSetId": {
"description": "Id of this MAP Set. mapSetId can be any integer in the allowable range, and must be unique across MAP Sets. If a mate RSP (/vstp/remotesignalingpoints) is being added to an existing MAP Set, the mapSetId must be the same as assigned to the MAP Set instance containing the primary RSP.",
"maximum": 36000,
"minimum": 1,
"type": "integer"
},
"messageRouteCongestion": {
"description": "Must be set to Yes if the Class 0 messages to the specified RSP (/vstp/remotesignalingpoints) can be routed to the next preferred node/subsystem when that RSP is congested. No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for messageRouteCongestion is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MAP Set. For the primary RSP, the default value is 10 and for a mate RSP the default value is 50.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"ssn": {
"description": "Defines the application's subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
},
"subsystemRoutingMessage": {
"description": "Must be set to Yes if the subsystem routing messages (SBR, SNR) are transmitted between the mated applications, No otherwise. If domain of RSP is ANSI, Default is equivalent to Yes. If domain of RSP is ITU, Defalut is equivalent to No. If not specified by user the value for subsystemRoutingMessage is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"subsystemStatusOption": {
"description": "Must be set to Yes if the RSP (/vstp/remotesignalingpoints) specified by rspName initiates a subsystem test when a RESUME message is received, No otherwise. Default is equivalent to No. If not specified by user the value for subsystemStatusOption is set to Default.[This attribute is NOT currently in use. Will be used in future.]",
"enum": [
"Default",
"Yes",
"No"
],
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold assigned to each combination of RSP (/vstp/remotesignalingpoints) and SSN in this MAP Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If this parameter is not specified, a value of 1% is assigned to each RSP in this MAP Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MAP Set. The unique identifier value is a combination of mapSetId, ssn and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-2-Rsp1, where 3 is the MAP Set Id, 2 is the ssn and Rsp1 is the RSP (/vstp/remotesignalingpoints) name.",
"readOnly": true,
"pattern": "^([0-9]*)(-)([0-9]*)(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the primary RSP (/vstp/remotesignalingpoints) of this MAP Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mapSetId",
"relativeCost",
"rspName",
"ssn"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"rspName": "Rsp1",
"mapSetId": 1,
"messageRouteCongestion": "No",
"relativeCost": 1,
"ssn": 2,
"subsystemRoutingMessage": "No",
"subsystemStatusOption": "No",
"threshold": 1,
"uniqueIdentifier": "1-2-Rsp1",
"weight": 1
}
delete /vstp/mapsets/{uniqueIdentifier}
Deletes the specified RSP (/vstp/remotesignalingpoints) from the MAP Set. If only one RSP is associated with the MAP Set, it is deleted and the groupId and mapSetId assigned to this MAP Set becomes available to configure a new MAP Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Vstp: MP Leader
An MP leader is an MP designated as a leader in an MP server group (/topo/servergroups). The MP leader is used internally by software for status reporting.
/vstp/mpleader
get /vstp/mpleader
Returns Active MP leader. If no MP leader is present or multiple MP leaaders are present, an error message is returned within the HTTP response.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mpleaderItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mpleader/mpleader.json",
"properties": {
"name": {
"description": "Name of the VSTP MP leader.",
"maxLength": 30,
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "VSTPMP1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
Vstp: MRN Sets
A Mated Relay Node (MRN) Set is a logical grouping of Remote Signaling Points (/vstp/remotesignalingpoints) referred as a load sharing group. The Default MRN Set (the MRN Set with mrnSetId equal to 0) can have multiple load sharing groups. All other MRN Sets can have only one load sharing group. A load sharing group can have at most 32 RSPs.
All configuration of MRN Sets is done at the SOAM.
/vstp/mrnsets
get /vstp/mrnsets
Returns all MRN Sets that meet the criteria specified in the GET request. By default, all MRN Sets configured at the SOAM are returned. If paging parameters are supplied, only those MRN Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mrnsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mrnset/mrnset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mrnSetId": {
"description": "Id of this MRN Set. mrnSetId can be any integer in the range. It must be unique across MRN sets.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MRN Set.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MRN Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold for all RSP (/vstp/remotesignalingpoints) in this MRN Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If value is not specified, threshold value of 1% will be assigned to all RSPs in this MRN Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MRN Set. The unique identifier value is a combination of mrnSetId and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-rsp1, where 3 is the MRN Set Id and rsp1 is the RSP name.",
"readOnly": true,
"pattern": "^(([0-9]*))(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the RSP (/vstp/remotesignalingpoints) of this MRN Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mrnSetId",
"rspName",
"relativeCost"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "1",
"mrnSetId": 1,
"relativeCost": 1,
"rspName": "Rsp1",
"threshold": 1,
"uniqueIdentifier": "1-Rsp1",
"weight": 1
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/mrnsets
Adds a new MRN Set entry to the VSTP configuration. The combination of mrnSetId, groupId and rspName must be unique across all MRN Set entries at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mrnset/mrnset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mrnSetId": {
"description": "Id of this MRN Set. mrnSetId can be any integer in the range. It must be unique across MRN sets.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MRN Set.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MRN Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold for all RSP (/vstp/remotesignalingpoints) in this MRN Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If value is not specified, threshold value of 1% will be assigned to all RSPs in this MRN Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MRN Set. The unique identifier value is a combination of mrnSetId and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-rsp1, where 3 is the MRN Set Id and rsp1 is the RSP name.",
"readOnly": true,
"pattern": "^(([0-9]*))(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the RSP (/vstp/remotesignalingpoints) of this MRN Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mrnSetId",
"rspName",
"relativeCost"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"mrnSetId": 1,
"relativeCost": 1,
"rspName": "Rsp1",
"threshold": 1,
"uniqueIdentifier": "1-Rsp1",
"weight": 1
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/mrnsets/{uniqueIdentifier}
get /vstp/mrnsets/{uniqueIdentifier}
Returns the configuration details for the specified MRN Set. If the MRN Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mrnsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mrnset/mrnset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mrnSetId": {
"description": "Id of this MRN Set. mrnSetId can be any integer in the range. It must be unique across MRN sets.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MRN Set.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MRN Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold for all RSP (/vstp/remotesignalingpoints) in this MRN Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If value is not specified, threshold value of 1% will be assigned to all RSPs in this MRN Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MRN Set. The unique identifier value is a combination of mrnSetId and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-rsp1, where 3 is the MRN Set Id and rsp1 is the RSP name.",
"readOnly": true,
"pattern": "^(([0-9]*))(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the RSP (/vstp/remotesignalingpoints) of this MRN Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mrnSetId",
"rspName",
"relativeCost"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "1",
"mrnSetId": 1,
"relativeCost": 1,
"rspName": "Rsp1",
"threshold": 1,
"uniqueIdentifier": "1-Rsp1",
"weight": 1
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/mrnsets/{uniqueIdentifier}
Updates the configuration of the specified MRN Set. If the provided MRN Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mrnset/mrnset.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mrnSetId": {
"description": "Id of this MRN Set. mrnSetId can be any integer in the range. It must be unique across MRN sets.",
"maximum": 1500,
"minimum": 1,
"type": "integer"
},
"relativeCost": {
"description": "Defines the relative cost of the route for the RSP (/vstp/remotesignalingpoints) of this MRN Set.",
"maximum": 99,
"minimum": 0,
"type":"integer"
},
"rspName": {
"description": "Defines the Remote Signaling Point name (/vstp/remotesignalingpoints) associated with this MRN Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"threshold": {
"description": "Defines the in-service threshold for all RSP (/vstp/remotesignalingpoints) in this MRN Set having the same relativeCost. The Weighted GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)) before this parameter can be specified. If value is not specified, threshold value of 1% will be assigned to all RSPs in this MRN Set.",
"maximum": 100,
"minimum": 1,
"type":"integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this MRN Set. The unique identifier value is a combination of mrnSetId and rspName. This identifier is created and assigned by vSTP. An example of a unique identifier is 3-rsp1, where 3 is the MRN Set Id and rsp1 is the RSP name.",
"readOnly": true,
"pattern": "^(([0-9]*))(-)(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"weight": {
"description": "Defines the weight assigned to the RSP (/vstp/remotesignalingpoints) of this MRN Set. Weight is not applicable for solitary and dominant modes. Weight is only valid for load sharing mode and its default is 1.",
"maximum": 99,
"minimum": 1,
"type":"integer"
}
},
"required": [
"mrnSetId",
"rspName",
"relativeCost"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"mrnSetId": 1,
"relativeCost": 1,
"rspName": "Rsp1",
"threshold": 1,
"uniqueIdentifier": "1-Rsp1",
"weight": 1
}
delete /vstp/mrnsets/{uniqueIdentifier}
Deletes the specified RSP (/vstp/remotesignalingpoints) from the MRN Set. If only one RSP is associated with the MRN Set, it is deleted and the groupId and mrnSetId assigned to this MRN Set becomes available to configure a new MRN Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Vstp: MTP Screen Sets
A MTP Screen Set is an entity which are assigned to MTP Screening Rules (/vstp/mtpscrrules) and used by MTP OPC Rule type, MTP SIO Rule type, MTP DPC Rule type,MTP BLKOPC Rule type, MTP BLKDPC Rule type or MTP DSTFLD Rule type.
All configuration of MTP Screen Sets is done at the SOAM.
/vstp/mtpscreensets
get /vstp/mtpscreensets
Returns all MTP Screen Sets that meet the criteria specified in the GET request. By default, all MTP Screen Sets configured at the SOAM are returned. If paging parameters are supplied, only those MTP Screen Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=MtpScrSet1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mtpscreensetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtpscreenset/mtpscreenset.json",
"properties": {
"name": {
"description": "Name for the VSTP MTP Screen Set, which must be unique within the VSTP site. Valid screen set names are strings between one and 8 characters, inclusive. Valid characters are alphanumeric. The screensetname must contain at least one alpha and must not start with a digit.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nextScrRuleGroupName": {
"description": "Allowed next screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nsfi": {
"description": "The NSFI defines the next screening category that is used in the gateway screening process,or it indicates that the gateway screening process should stop.",
"default": "Pass",
"enum": [
"BlkDpc",
"BlkOpc",
"Dpc",
"Opc",
"Sio"
],
"type": "string"
}
},
"required": [
"name",
"nextScrRuleGroupName",
"nsfi"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "scrset1",
"nextScrRuleGroupName": "scr1",
"nsfi": "Opc"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/mtpscreensets
Adds a new MTP Screen Set to the VSTP configuration. The MTP Screen Set name must be unique across all MTP Screen Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtpscreenset/mtpscreenset.json",
"properties": {
"name": {
"description": "Name for the VSTP MTP Screen Set, which must be unique within the VSTP site. Valid screen set names are strings between one and 8 characters, inclusive. Valid characters are alphanumeric. The screensetname must contain at least one alpha and must not start with a digit.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nextScrRuleGroupName": {
"description": "Allowed next screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nsfi": {
"description": "The NSFI defines the next screening category that is used in the gateway screening process,or it indicates that the gateway screening process should stop.",
"default": "Pass",
"enum": [
"BlkDpc",
"BlkOpc",
"Dpc",
"Opc",
"Sio"
],
"type": "string"
}
},
"required": [
"name",
"nextScrRuleGroupName",
"nsfi"
],
"type": "object"
}
Example
{
"name": "scrset1",
"nextScrRuleGroupName": "scr1",
"nsfi": "Opc"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/mtpscreensets/{name}
get /vstp/mtpscreensets/{name}
Returns the configuration details for the specified MTP Screen Set. If the MTP Screen Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mtpscreensetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtpscreenset/mtpscreenset.json",
"properties": {
"name": {
"description": "Name for the VSTP MTP Screen Set, which must be unique within the VSTP site. Valid screen set names are strings between one and 8 characters, inclusive. Valid characters are alphanumeric. The screensetname must contain at least one alpha and must not start with a digit.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nextScrRuleGroupName": {
"description": "Allowed next screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nsfi": {
"description": "The NSFI defines the next screening category that is used in the gateway screening process,or it indicates that the gateway screening process should stop.",
"default": "Pass",
"enum": [
"BlkDpc",
"BlkOpc",
"Dpc",
"Opc",
"Sio"
],
"type": "string"
}
},
"required": [
"name",
"nextScrRuleGroupName",
"nsfi"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "scrset1",
"nextScrRuleGroupName": "scr1",
"nsfi": "Opc"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/mtpscreensets/{name}
delete /vstp/mtpscreensets/{name}
Deletes the specified MTP Screen Set from the SOAM configuration. A MTP Screen Set can only be deleted if all delete validation checks pass. If the MTP Screen Set is part of the configuration of one or more MTP Selector (/vstp/mtpselectors) and MTP OPC Rule (/vstp/mtpopcrules) and/or MTP SIO Rule (/vstp/mtpsiorules) and/or MTP DPC Rule and/or MTP BLKOPC Rule and/or MTP BLKDPC Rule and/or MTP DSTFLD Rule, the MTP Screen Set must first be removed from the MTP Selector (/vstp/mtpselectors) and MTP OPC Rule (/vstp/mtpopcrules) and/or MTP SIO Rule (/vstp/mtpsiorules) and/or MTP DPC Rule and/or MTP BLKOPC Rule and/or MTP BLKDPC Rule and/or MTP DSTFLD Rule. An attempt to delete a MTP Screen Set that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: MTP Screening Rules
A MTP Screening Rule is an entity to configure all the screening rules for a Screen Set (/vstp/mtpscreensets/).
All configuration of MTP Screening Rule is done at the SOAM.
/vstp/mtpscreeningrules
get /vstp/mtpscreeningrules
Returns all MTP Screening Rules that meet the criteria specified in the GET request. By default, all MTP Screening Rules configured at the SOAM are returned. If paging parameters are supplied, only those MTP Screening Rules meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mtpscreeningruleCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtpscreeningrule/mtpscreeningrule.json",
"properties": {
"actionSccp": {
"description": "Specifies whether the given MTP Screening Rule will include SCCP Stop Action screening.",
"default": false,
"type": "boolean"
},
"actionIsup": {
"description": "TIF Stop Action (This field is only valid for SIO if si equals 5. Only valid when nsfi=STOP).",
"enum": [
"None",
"Tif_Ruleset_1",
"Tif_Ruleset_2",
"Tif_Ruleset_3"
],
"default": "None",
"type": "string"
},
"area": {
"description": "ITU international area. The area in the point code represented by zone-area-id.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"h0Code": {
"description": "H0 Heading code. New H0 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"h1Code": {
"description": "H1 Heading code. New H1 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"signalingPointId": {
"description": "ITU international ID. The ID in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[*]$|^[D]$",
"type": "string"
},
"mainNumberArea": {
"description": "16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0-2]?[0-9])|([3][0-1]))(-))?(([0-2]?[0-9])|([3][0-1]))$|^[*]$|^[D]$",
"type": "string"
},
"mainSignalingArea": {
"description": "24-bit ITU-national main signaling area value. The msa of the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"nationalPointCode": {
"description": "ITU national point code.",
"maxLength": 11,
"pattern": "^((([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))(-))?(([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))$|^[D]$",
"type": "string"
},
"networkCluster": {
"description": "Network cluster value. This parameter specifies one or more nc values for the network indicator and network cluster member values specified in the ni and ncm parameters. It specifies the nc of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkClusterMember": {
"description": "Network cluster member value. This parameter specifies one or more ncm values for the network indicator and network cluster values identified in the ni and nc parameters. It specifies the ncm of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkIndicator": {
"description": "Network indicator value. This parameter specifies one or more ni values for the network cluster and network cluster member values identified in the nc and ncm parameters. It specifies the ni of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"networkIndicatorCode": {
"description": "Network indicator code. The NIC is the last 2 bits of the subservice field of an SIO.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"nextScrRuleGroupName": {
"description": "Allowed next screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nsfi": {
"description": "This parameter specifies the next screening category that is used in the MTP screening process, or it indicates that the MTP screening process should stop.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Fail",
"Opc",
"Sio",
"Stop"
],
"type": "string"
},
"priority": {
"description": "Message priority.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"ruleName": {
"description": "MTP screening rule name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"scrRuleGroupType": {
"description": "This indicates type of the screening rule group.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Opc",
"Sio"
],
"type": "string"
},
"scrRuleGroupName": {
"description": "Allowed screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"serviceIndicator": {
"description": "Service indicator. The SI is the first 4 bits of an SIO. The SS7 code directs the message to the MTP-user at the destination code.",
"maxLength": 5,
"pattern": "^((([0]?[3-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$",
"type": "string"
},
"signalingPoint": {
"description": "24-bit ITU national signaling point. This parameter specifies the sp in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subNumberArea": {
"description": "16-bit ITU national sub number area. The sna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subSignalingArea": {
"description": "24-bit ITU national sub signaling area. The ssa in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"unitNumber": {
"description": "16-bit ITU-national unit number. The un of the point code represented by un-sna-mna.",
"maxLength": 7,
"pattern": "^((([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))(-))?(([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))$|^[D]$",
"type": "string"
},
"zone": {
"description": "ITU international zone. This parameter specifies the zone in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[D]$",
"type": "string"
}
},
"required": [
"nsfi",
"ruleName",
"scrRuleGroupType",
"scrRuleGroupName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"h0Code": "1-5",
"h1Code": "*",
"networkIndicatorCode": "0-2",
"nextScrRuleGroupName": "scr1",
"nsfi": "Dpc",
"priority": "2",
"ruleName": "rule1",
"scrRuleGroupType": "Sio",
"scrRuleGroupName": "scr2",
"serviceIndicator": "0",
"actionSccp": true
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/mtpscreeningrules
Adds a new MTP Screening Rule to the VSTP configuration. If the provided MTP Screening Rule data is invalid in any way, the insert fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtpscreeningrule/mtpscreeningrule.json",
"properties": {
"actionSccp": {
"description": "Specifies whether the given MTP Screening Rule will include SCCP Stop Action screening.",
"default": false,
"type": "boolean"
},
"actionIsup": {
"description": "TIF Stop Action (This field is only valid for SIO if si equals 5. Only valid when nsfi=STOP).",
"enum": [
"None",
"Tif_Ruleset_1",
"Tif_Ruleset_2",
"Tif_Ruleset_3"
],
"default": "None",
"type": "string"
},
"area": {
"description": "ITU international area. The area in the point code represented by zone-area-id.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"h0Code": {
"description": "H0 Heading code. New H0 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"h1Code": {
"description": "H1 Heading code. New H1 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"signalingPointId": {
"description": "ITU international ID. The ID in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[*]$|^[D]$",
"type": "string"
},
"mainNumberArea": {
"description": "16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0-2]?[0-9])|([3][0-1]))(-))?(([0-2]?[0-9])|([3][0-1]))$|^[*]$|^[D]$",
"type": "string"
},
"mainSignalingArea": {
"description": "24-bit ITU-national main signaling area value. The msa of the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"nationalPointCode": {
"description": "ITU national point code.",
"maxLength": 11,
"pattern": "^((([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))(-))?(([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))$|^[D]$",
"type": "string"
},
"networkCluster": {
"description": "Network cluster value. This parameter specifies one or more nc values for the network indicator and network cluster member values specified in the ni and ncm parameters. It specifies the nc of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkClusterMember": {
"description": "Network cluster member value. This parameter specifies one or more ncm values for the network indicator and network cluster values identified in the ni and nc parameters. It specifies the ncm of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkIndicator": {
"description": "Network indicator value. This parameter specifies one or more ni values for the network cluster and network cluster member values identified in the nc and ncm parameters. It specifies the ni of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"networkIndicatorCode": {
"description": "Network indicator code. The NIC is the last 2 bits of the subservice field of an SIO.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"nextScrRuleGroupName": {
"description": "Allowed next screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nsfi": {
"description": "This parameter specifies the next screening category that is used in the MTP screening process, or it indicates that the MTP screening process should stop.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Fail",
"Opc",
"Sio",
"Stop"
],
"type": "string"
},
"priority": {
"description": "Message priority.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"ruleName": {
"description": "MTP screening rule name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"scrRuleGroupType": {
"description": "This indicates type of the screening rule group.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Opc",
"Sio"
],
"type": "string"
},
"scrRuleGroupName": {
"description": "Allowed screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"serviceIndicator": {
"description": "Service indicator. The SI is the first 4 bits of an SIO. The SS7 code directs the message to the MTP-user at the destination code.",
"maxLength": 5,
"pattern": "^((([0]?[3-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$",
"type": "string"
},
"signalingPoint": {
"description": "24-bit ITU national signaling point. This parameter specifies the sp in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subNumberArea": {
"description": "16-bit ITU national sub number area. The sna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subSignalingArea": {
"description": "24-bit ITU national sub signaling area. The ssa in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"unitNumber": {
"description": "16-bit ITU-national unit number. The un of the point code represented by un-sna-mna.",
"maxLength": 7,
"pattern": "^((([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))(-))?(([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))$|^[D]$",
"type": "string"
},
"zone": {
"description": "ITU international zone. This parameter specifies the zone in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[D]$",
"type": "string"
}
},
"required": [
"nsfi",
"ruleName",
"scrRuleGroupType",
"scrRuleGroupName"
],
"type": "object"
}
Example
{
"h0Code": "1-5",
"h1Code": "*",
"networkIndicatorCode": "0-2",
"nextScrRuleGroupName": "scr1",
"nsfi": "Dpc",
"priority": "2",
"ruleName": "rule1",
"scrRuleGroupType": "Sio",
"scrRuleGroupName": "scr2",
"serviceIndicator": "0",
"actionSccp": true
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/mtpscreeningrules/{ruleName}
get /vstp/mtpscreeningrules/{ruleName}
Returns the configuration details for the specified MTP Screening Rule. If the MTP Screening Rule does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- ruleName: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mtpscreeningruleItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtpscreeningrule/mtpscreeningrule.json",
"properties": {
"actionSccp": {
"description": "Specifies whether the given MTP Screening Rule will include SCCP Stop Action screening.",
"default": false,
"type": "boolean"
},
"actionIsup": {
"description": "TIF Stop Action (This field is only valid for SIO if si equals 5. Only valid when nsfi=STOP).",
"enum": [
"None",
"Tif_Ruleset_1",
"Tif_Ruleset_2",
"Tif_Ruleset_3"
],
"default": "None",
"type": "string"
},
"area": {
"description": "ITU international area. The area in the point code represented by zone-area-id.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"h0Code": {
"description": "H0 Heading code. New H0 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"h1Code": {
"description": "H1 Heading code. New H1 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"signalingPointId": {
"description": "ITU international ID. The ID in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[*]$|^[D]$",
"type": "string"
},
"mainNumberArea": {
"description": "16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0-2]?[0-9])|([3][0-1]))(-))?(([0-2]?[0-9])|([3][0-1]))$|^[*]$|^[D]$",
"type": "string"
},
"mainSignalingArea": {
"description": "24-bit ITU-national main signaling area value. The msa of the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"nationalPointCode": {
"description": "ITU national point code.",
"maxLength": 11,
"pattern": "^((([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))(-))?(([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))$|^[D]$",
"type": "string"
},
"networkCluster": {
"description": "Network cluster value. This parameter specifies one or more nc values for the network indicator and network cluster member values specified in the ni and ncm parameters. It specifies the nc of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkClusterMember": {
"description": "Network cluster member value. This parameter specifies one or more ncm values for the network indicator and network cluster values identified in the ni and nc parameters. It specifies the ncm of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkIndicator": {
"description": "Network indicator value. This parameter specifies one or more ni values for the network cluster and network cluster member values identified in the nc and ncm parameters. It specifies the ni of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"networkIndicatorCode": {
"description": "Network indicator code. The NIC is the last 2 bits of the subservice field of an SIO.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"nextScrRuleGroupName": {
"description": "Allowed next screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nsfi": {
"description": "This parameter specifies the next screening category that is used in the MTP screening process, or it indicates that the MTP screening process should stop.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Fail",
"Opc",
"Sio",
"Stop"
],
"type": "string"
},
"priority": {
"description": "Message priority.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"ruleName": {
"description": "MTP screening rule name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"scrRuleGroupType": {
"description": "This indicates type of the screening rule group.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Opc",
"Sio"
],
"type": "string"
},
"scrRuleGroupName": {
"description": "Allowed screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"serviceIndicator": {
"description": "Service indicator. The SI is the first 4 bits of an SIO. The SS7 code directs the message to the MTP-user at the destination code.",
"maxLength": 5,
"pattern": "^((([0]?[3-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$",
"type": "string"
},
"signalingPoint": {
"description": "24-bit ITU national signaling point. This parameter specifies the sp in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subNumberArea": {
"description": "16-bit ITU national sub number area. The sna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subSignalingArea": {
"description": "24-bit ITU national sub signaling area. The ssa in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"unitNumber": {
"description": "16-bit ITU-national unit number. The un of the point code represented by un-sna-mna.",
"maxLength": 7,
"pattern": "^((([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))(-))?(([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))$|^[D]$",
"type": "string"
},
"zone": {
"description": "ITU international zone. This parameter specifies the zone in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[D]$",
"type": "string"
}
},
"required": [
"nsfi",
"ruleName",
"scrRuleGroupType",
"scrRuleGroupName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"h0Code": "1-5",
"h1Code": "*",
"networkIndicatorCode": "0-2",
"nextScrRuleGroupName": "scr1",
"nsfi": "Dpc",
"priority": "2",
"ruleName": "rule1",
"scrRuleGroupType": "Sio",
"scrRuleGroupName": "scr2",
"serviceIndicator": "0",
"actionSccp": true
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/mtpscreeningrules/{ruleName}
Updates the configuration of the specified MTP Screening Rule. If the provided MTP Screening Rule data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- ruleName: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtpscreeningrule/mtpscreeningrule.json",
"properties": {
"actionSccp": {
"description": "Specifies whether the given MTP Screening Rule will include SCCP Stop Action screening.",
"default": false,
"type": "boolean"
},
"actionIsup": {
"description": "TIF Stop Action (This field is only valid for SIO if si equals 5. Only valid when nsfi=STOP).",
"enum": [
"None",
"Tif_Ruleset_1",
"Tif_Ruleset_2",
"Tif_Ruleset_3"
],
"default": "None",
"type": "string"
},
"area": {
"description": "ITU international area. The area in the point code represented by zone-area-id.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"h0Code": {
"description": "H0 Heading code. New H0 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"h1Code": {
"description": "H1 Heading code. New H1 heading code for SSNM message.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$",
"type": "string"
},
"signalingPointId": {
"description": "ITU international ID. The ID in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[*]$|^[D]$",
"type": "string"
},
"mainNumberArea": {
"description": "16-bit ITU national main number area. The mna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0-2]?[0-9])|([3][0-1]))(-))?(([0-2]?[0-9])|([3][0-1]))$|^[*]$|^[D]$",
"type": "string"
},
"mainSignalingArea": {
"description": "24-bit ITU-national main signaling area value. The msa of the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"nationalPointCode": {
"description": "ITU national point code.",
"maxLength": 11,
"pattern": "^((([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))(-))?(([0]?[0-9]{1,4})|([1][0-5][0-9]{1,3})|(16[0-2][0-9]{1,2})|(163[0-7][0-9])|(1638[0-3]))$|^[D]$",
"type": "string"
},
"networkCluster": {
"description": "Network cluster value. This parameter specifies one or more nc values for the network indicator and network cluster member values specified in the ni and ncm parameters. It specifies the nc of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkClusterMember": {
"description": "Network cluster member value. This parameter specifies one or more ncm values for the network indicator and network cluster values identified in the ni and nc parameters. It specifies the ncm of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"networkIndicator": {
"description": "Network indicator value. This parameter specifies one or more ni values for the network cluster and network cluster member values identified in the nc and ncm parameters. It specifies the ni of the point code represented by ni-nc-ncm.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[D]$",
"type": "string"
},
"networkIndicatorCode": {
"description": "Network indicator code. The NIC is the last 2 bits of the subservice field of an SIO.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"nextScrRuleGroupName": {
"description": "Allowed next screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"nsfi": {
"description": "This parameter specifies the next screening category that is used in the MTP screening process, or it indicates that the MTP screening process should stop.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Fail",
"Opc",
"Sio",
"Stop"
],
"type": "string"
},
"priority": {
"description": "Message priority.",
"maxLength": 3,
"pattern": "^(([0-3])(-))?([0-3])$|^[*]$",
"type": "string"
},
"ruleName": {
"description": "MTP screening rule name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"scrRuleGroupType": {
"description": "This indicates type of the screening rule group.",
"enum": [
"AftDstn",
"BlkDpc",
"BlkOpc",
"Dpc",
"Opc",
"Sio"
],
"type": "string"
},
"scrRuleGroupName": {
"description": "Allowed screening rule group name. 1 alphabetic character followed by up to 7 alphanumeric characters.",
"maxLength": 8,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"serviceIndicator": {
"description": "Service indicator. The SI is the first 4 bits of an SIO. The SS7 code directs the message to the MTP-user at the destination code.",
"maxLength": 5,
"pattern": "^((([0]?[3-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$",
"type": "string"
},
"signalingPoint": {
"description": "24-bit ITU national signaling point. This parameter specifies the sp in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subNumberArea": {
"description": "16-bit ITU national sub number area. The sna in the point code represented by un-sna-mna.",
"maxLength": 5,
"pattern": "^((([0]?[0-9])|([1][0-5]))(-))?(([0]?[0-9])|([1][0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"subSignalingArea": {
"description": "24-bit ITU national sub signaling area. The ssa in the point code represented by msa-ssa-sp.",
"maxLength": 7,
"pattern": "^((([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))(-))?(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^[D]$",
"type": "string"
},
"unitNumber": {
"description": "16-bit ITU-national unit number. The un of the point code represented by un-sna-mna.",
"maxLength": 7,
"pattern": "^((([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))(-))?(([0]?[0-9]?[0-9])|([1][0-1][0-9])|(12[0-7]))$|^[D]$",
"type": "string"
},
"zone": {
"description": "ITU international zone. This parameter specifies the zone in the point code represented by zone-area-id.",
"maxLength": 3,
"pattern": "^(([0-7])(-))?([0-7])$|^[D]$",
"type": "string"
}
},
"required": [
"nsfi",
"ruleName",
"scrRuleGroupType",
"scrRuleGroupName"
],
"type": "object"
}
Example
{
"h0Code": "1-5",
"h1Code": "*",
"networkIndicatorCode": "0-2",
"nextScrRuleGroupName": "scr1",
"nsfi": "Dpc",
"priority": "2",
"ruleName": "rule1",
"scrRuleGroupType": "Sio",
"scrRuleGroupName": "scr2",
"serviceIndicator": "0",
"actionSccp": true
}
delete /vstp/mtpscreeningrules/{ruleName}
Deletes the specified MTP Screening Rule from the SOAM configuration. A MTP Screening Rule can only be deleted if all delete validation checks pass. In general, An attempt to delete a MTP Screening Rule that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- ruleName: required (string)
Vstp: NPP Action Sets
A Numbering Plan Processor (NPP) Action Set is a collection of Conditioning Actions (CAs), Service Actions (SAs), and Formatting Actions (FAs).
All configuration of the NPP Action Sets is done at the SOAM.
/vstp/nppactionsets
get /vstp/nppactionsets
Returns all NPP Action Sets that meet the criteria specified in the GET request. By default, all NPP Action Sets configured at the SOAM are returned. If paging parameters are supplied, only those NPP Action Sets meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/nppactionsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppactionset/nppactionset.json",
"properties": {
"actSetName": {
"description": "Action Set Name. This parameter specifies the name of the Action Set. Allowable values are 1 alphabetic character followed by up to 9 alphanumeric characters.",
"maxLength": 10,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"caList": {
"description": "Conditioning Action list. This CA list can be applied to an incoming digit string. Up to 12 CAs can be specified in the list. The CAs are processed in the order they are specified in the list.",
"items": {
"enum" : [
"Ac1",
"Ac2",
"Ac3",
"Ac4",
"Ac5",
"Ac6",
"Ac7",
"Ac8",
"Accgpn",
"Accgpn1",
"Accgpn2",
"Accgpn3",
"Accgpn4",
"Accgpn5",
"Accgpn6",
"Accgpn7",
"Accgpn8",
"Acdef",
"Aclac",
"Cc1",
"Cc2",
"Cc3",
"Ccdef",
"Cccgpn",
"Dn1",
"Dn2",
"Dn3",
"Dn4",
"Dn5",
"Dn6",
"Dn7",
"Dn8",
"Dn9",
"Dn10",
"Dn11",
"Dn12",
"Dn13",
"Dn14",
"Dn15",
"Dnx",
"Fpfx",
"Ign1",
"Ign2",
"Ign3",
"Ign4",
"Ign5",
"Ign6",
"Ign7",
"Ign8",
"Ign9",
"Ign10",
"Pfxa1",
"Pfxa2",
"Pfxa3",
"Pfxa4",
"Pfxa5",
"Pfxa6",
"Pfxa7",
"Pfxa8",
"Pfxb1",
"Pfxb2",
"Pfxb3",
"Pfxb4",
"Pfxb5",
"Pfxb6",
"Pfxb7",
"Pfxb8",
"Pfxc1",
"Pfxc2",
"Pfxc3",
"Pfxc4",
"Pfxc5",
"Pfxc6",
"Pfxc7",
"Pfxc8",
"Pfxd1",
"Pfxd2",
"Pfxd3",
"Pfxd4",
"Pfxd5",
"Pfxd6",
"Pfxd7",
"Pfxd8",
"Pfxe1",
"Pfxe2",
"Pfxe3",
"Pfxe4",
"Pfxe5",
"Pfxe6",
"Pfxe7",
"Pfxe8",
"Pfxf1",
"Pfxf2",
"Pfxf3",
"Pfxf4",
"Pfxf5",
"Pfxf6",
"Pfxf7",
"Pfxf8",
"Sn1",
"Sn2",
"Sn3",
"Sn4",
"Sn5",
"Sn6",
"Sn7",
"Sn8",
"Sn9",
"Sn10",
"Sn11",
"Sn12",
"Sn13",
"Sn14",
"Sn15",
"Snx",
"Znx"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"saList": {
"description": "Service Action list. This SA list can be applied to an incoming digit string. Up to 8 SAs can be specified in the list. The SAs must be specified in high-to-low precedence order in the list, and cannot be duplicated in the list.",
"items": {
"enum" : [
"Asdlkup",
"Blklstqry",
"Blklstrly",
"Blnfndrls",
"Blrls",
"Cdial",
"Ccncchk",
"Cdpnnp",
"Cgpnasdrqd",
"Cgpngrnrqd",
"Cgpnnp",
"Cgpnrtg",
"Cgpnsvcrqd",
"Crp",
"Fpfxrls",
"Fraudchk",
"Fwdscs",
"Grnlkup",
"Inprtg",
"Lacck",
"Migrate",
"Nocgpnrls",
"Npnrls",
"Nprelay",
"Nprls",
"Nscgpn",
"Nscdpn",
"Pprelay",
"Rtdbtrn",
"Rtdbtsp",
"Rtdbtrnsp",
"Selscr",
"Skgtartg",
"Snscgpn",
"Tifgnbl",
"Tiflsbl",
"Tifrdnbl"
],
"type": "string"
},
"maxItems": 8,
"minItems": 0,
"type": "array"
},
"sa1dgts": {
"description": "Service Action 1 digit string. This parameter specifies a digit string that can be used with the first SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa2dgts": {
"description": "Service Action 2 digit string. This parameter specifies a digit string that can be used with the second SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa3dgts": {
"description": "Service Action 3 digit string. This parameter specifies a digit string that can be used with the third SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa4dgts": {
"description": "Service Action 4 digit string. This parameter specifies a digit string that can be used with the fourth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa5dgts": {
"description": "Service Action 5 digit string. This parameter specifies a digit string that can be used with the fifth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa6dgts": {
"description": "Service Action 6 digit string. This parameter specifies a digit string that can be used with the sixth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa7dgts": {
"description": "Service Action 7 digit string. This parameter specifies a digit string that can be used with the seventh SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa8dgts": {
"description": "Service Action 8 digit string. This parameter specifies a digit string that can be used with the eighth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa1val": {
"description": "Service Action 1 numerical values list. A comma-separated numerical values list that can be used with the first SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa2val": {
"description": "Service Action 2 numerical values list. A comma-separated numerical values list that can be used with the second SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa3val": {
"description": "Service Action 3 numerical values list. A comma-separated numerical values list that can be used with the third SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa4val": {
"description": "Service Action 4 numerical values list. A comma-separated numerical values list that can be used with the fourth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa5val": {
"description": "Service Action 5 numerical values list. A comma-separated numerical values list that can be used with the fifth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa6val": {
"description": "Service Action 6 numerical values list. A comma-separated numerical values list that can be used with the sixth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa7val": {
"description": "Service Action 7 numerical values list. A comma-separated numerical values list that can be used with the seventh SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa8val": {
"description": "Service Action 8 numerical values list. A comma-separated numerical values list that can be used with the eighth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"faList": {
"description": "Formatting Action list. This FA list can be applied to the outgoing digit string. Up to 12 FAs can be specified in the list. The FAs are processed in the order they are specified in the list and cannot be duplicated.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fane": {
"description": "Formatting Action list type Fane. Formatting Action List when the SP and RN entities are not associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fanf": {
"description": "Formatting Action list type Fanf. Formatting Action when the DN is not present in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"farn": {
"description": "Formatting Action list type Farn. Formatting Action List when the RN network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fasp": {
"description": "Formatting Action list type Fasp. Formatting Action List when the SP network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcd": {
"description": "Formatting Action list type Fascrcd. Formatting Action List to format ISUP CdPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcg": {
"description": "Formatting Action list type Fascrcg. Formatting Action List to format ISUP CgPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"ofnai": {
"description": "Outgoing filter nature of address indicator. The filter nature of address indicator (FNAI) class of the outgoing digit string.",
"enum" : [
"Intl",
"Natl",
"Nai1",
"Nai2",
"Nai3",
"Unkn",
"Inc"
],
"type": "string"
}
},
"required": ["actSetName"],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"actSetName": "ASN1",
"caList": [
"Cc1",
"Dn3"
],
"faList": [
"Cc"
],
"ofnai": "Inc",
"saList": [
"Blklstrly",
"Ccncchk",
"Nprelay"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/nppactionsets
Adds a new NPP Action Set to the VSTP configuration. The NPP Action Set name must be unique across all NPP Action Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppactionset/nppactionset.json",
"properties": {
"actSetName": {
"description": "Action Set Name. This parameter specifies the name of the Action Set. Allowable values are 1 alphabetic character followed by up to 9 alphanumeric characters.",
"maxLength": 10,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"caList": {
"description": "Conditioning Action list. This CA list can be applied to an incoming digit string. Up to 12 CAs can be specified in the list. The CAs are processed in the order they are specified in the list.",
"items": {
"enum" : [
"Ac1",
"Ac2",
"Ac3",
"Ac4",
"Ac5",
"Ac6",
"Ac7",
"Ac8",
"Accgpn",
"Accgpn1",
"Accgpn2",
"Accgpn3",
"Accgpn4",
"Accgpn5",
"Accgpn6",
"Accgpn7",
"Accgpn8",
"Acdef",
"Aclac",
"Cc1",
"Cc2",
"Cc3",
"Ccdef",
"Cccgpn",
"Dn1",
"Dn2",
"Dn3",
"Dn4",
"Dn5",
"Dn6",
"Dn7",
"Dn8",
"Dn9",
"Dn10",
"Dn11",
"Dn12",
"Dn13",
"Dn14",
"Dn15",
"Dnx",
"Fpfx",
"Ign1",
"Ign2",
"Ign3",
"Ign4",
"Ign5",
"Ign6",
"Ign7",
"Ign8",
"Ign9",
"Ign10",
"Pfxa1",
"Pfxa2",
"Pfxa3",
"Pfxa4",
"Pfxa5",
"Pfxa6",
"Pfxa7",
"Pfxa8",
"Pfxb1",
"Pfxb2",
"Pfxb3",
"Pfxb4",
"Pfxb5",
"Pfxb6",
"Pfxb7",
"Pfxb8",
"Pfxc1",
"Pfxc2",
"Pfxc3",
"Pfxc4",
"Pfxc5",
"Pfxc6",
"Pfxc7",
"Pfxc8",
"Pfxd1",
"Pfxd2",
"Pfxd3",
"Pfxd4",
"Pfxd5",
"Pfxd6",
"Pfxd7",
"Pfxd8",
"Pfxe1",
"Pfxe2",
"Pfxe3",
"Pfxe4",
"Pfxe5",
"Pfxe6",
"Pfxe7",
"Pfxe8",
"Pfxf1",
"Pfxf2",
"Pfxf3",
"Pfxf4",
"Pfxf5",
"Pfxf6",
"Pfxf7",
"Pfxf8",
"Sn1",
"Sn2",
"Sn3",
"Sn4",
"Sn5",
"Sn6",
"Sn7",
"Sn8",
"Sn9",
"Sn10",
"Sn11",
"Sn12",
"Sn13",
"Sn14",
"Sn15",
"Snx",
"Znx"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"saList": {
"description": "Service Action list. This SA list can be applied to an incoming digit string. Up to 8 SAs can be specified in the list. The SAs must be specified in high-to-low precedence order in the list, and cannot be duplicated in the list.",
"items": {
"enum" : [
"Asdlkup",
"Blklstqry",
"Blklstrly",
"Blnfndrls",
"Blrls",
"Cdial",
"Ccncchk",
"Cdpnnp",
"Cgpnasdrqd",
"Cgpngrnrqd",
"Cgpnnp",
"Cgpnrtg",
"Cgpnsvcrqd",
"Crp",
"Fpfxrls",
"Fraudchk",
"Fwdscs",
"Grnlkup",
"Inprtg",
"Lacck",
"Migrate",
"Nocgpnrls",
"Npnrls",
"Nprelay",
"Nprls",
"Nscgpn",
"Nscdpn",
"Pprelay",
"Rtdbtrn",
"Rtdbtsp",
"Rtdbtrnsp",
"Selscr",
"Skgtartg",
"Snscgpn",
"Tifgnbl",
"Tiflsbl",
"Tifrdnbl"
],
"type": "string"
},
"maxItems": 8,
"minItems": 0,
"type": "array"
},
"sa1dgts": {
"description": "Service Action 1 digit string. This parameter specifies a digit string that can be used with the first SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa2dgts": {
"description": "Service Action 2 digit string. This parameter specifies a digit string that can be used with the second SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa3dgts": {
"description": "Service Action 3 digit string. This parameter specifies a digit string that can be used with the third SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa4dgts": {
"description": "Service Action 4 digit string. This parameter specifies a digit string that can be used with the fourth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa5dgts": {
"description": "Service Action 5 digit string. This parameter specifies a digit string that can be used with the fifth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa6dgts": {
"description": "Service Action 6 digit string. This parameter specifies a digit string that can be used with the sixth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa7dgts": {
"description": "Service Action 7 digit string. This parameter specifies a digit string that can be used with the seventh SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa8dgts": {
"description": "Service Action 8 digit string. This parameter specifies a digit string that can be used with the eighth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa1val": {
"description": "Service Action 1 numerical values list. A comma-separated numerical values list that can be used with the first SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa2val": {
"description": "Service Action 2 numerical values list. A comma-separated numerical values list that can be used with the second SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa3val": {
"description": "Service Action 3 numerical values list. A comma-separated numerical values list that can be used with the third SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa4val": {
"description": "Service Action 4 numerical values list. A comma-separated numerical values list that can be used with the fourth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa5val": {
"description": "Service Action 5 numerical values list. A comma-separated numerical values list that can be used with the fifth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa6val": {
"description": "Service Action 6 numerical values list. A comma-separated numerical values list that can be used with the sixth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa7val": {
"description": "Service Action 7 numerical values list. A comma-separated numerical values list that can be used with the seventh SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa8val": {
"description": "Service Action 8 numerical values list. A comma-separated numerical values list that can be used with the eighth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"faList": {
"description": "Formatting Action list. This FA list can be applied to the outgoing digit string. Up to 12 FAs can be specified in the list. The FAs are processed in the order they are specified in the list and cannot be duplicated.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fane": {
"description": "Formatting Action list type Fane. Formatting Action List when the SP and RN entities are not associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fanf": {
"description": "Formatting Action list type Fanf. Formatting Action when the DN is not present in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"farn": {
"description": "Formatting Action list type Farn. Formatting Action List when the RN network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fasp": {
"description": "Formatting Action list type Fasp. Formatting Action List when the SP network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcd": {
"description": "Formatting Action list type Fascrcd. Formatting Action List to format ISUP CdPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcg": {
"description": "Formatting Action list type Fascrcg. Formatting Action List to format ISUP CgPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"ofnai": {
"description": "Outgoing filter nature of address indicator. The filter nature of address indicator (FNAI) class of the outgoing digit string.",
"enum" : [
"Intl",
"Natl",
"Nai1",
"Nai2",
"Nai3",
"Unkn",
"Inc"
],
"type": "string"
}
},
"required": ["actSetName"],
"type": "object"
}
Example
{
"actSetName": "ASN1",
"caList": [
"Cc1",
"Dn3"
],
"faList": [
"Cc"
],
"ofnai": "Inc",
"saList": [
"Blklstrly",
"Ccncchk",
"Nprelay"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/nppactionsets/{name}
get /vstp/nppactionsets/{name}
Returns the configuration details for the specified NPP Action Set. If the NPP Action Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/nppactionsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppactionset/nppactionset.json",
"properties": {
"actSetName": {
"description": "Action Set Name. This parameter specifies the name of the Action Set. Allowable values are 1 alphabetic character followed by up to 9 alphanumeric characters.",
"maxLength": 10,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"caList": {
"description": "Conditioning Action list. This CA list can be applied to an incoming digit string. Up to 12 CAs can be specified in the list. The CAs are processed in the order they are specified in the list.",
"items": {
"enum" : [
"Ac1",
"Ac2",
"Ac3",
"Ac4",
"Ac5",
"Ac6",
"Ac7",
"Ac8",
"Accgpn",
"Accgpn1",
"Accgpn2",
"Accgpn3",
"Accgpn4",
"Accgpn5",
"Accgpn6",
"Accgpn7",
"Accgpn8",
"Acdef",
"Aclac",
"Cc1",
"Cc2",
"Cc3",
"Ccdef",
"Cccgpn",
"Dn1",
"Dn2",
"Dn3",
"Dn4",
"Dn5",
"Dn6",
"Dn7",
"Dn8",
"Dn9",
"Dn10",
"Dn11",
"Dn12",
"Dn13",
"Dn14",
"Dn15",
"Dnx",
"Fpfx",
"Ign1",
"Ign2",
"Ign3",
"Ign4",
"Ign5",
"Ign6",
"Ign7",
"Ign8",
"Ign9",
"Ign10",
"Pfxa1",
"Pfxa2",
"Pfxa3",
"Pfxa4",
"Pfxa5",
"Pfxa6",
"Pfxa7",
"Pfxa8",
"Pfxb1",
"Pfxb2",
"Pfxb3",
"Pfxb4",
"Pfxb5",
"Pfxb6",
"Pfxb7",
"Pfxb8",
"Pfxc1",
"Pfxc2",
"Pfxc3",
"Pfxc4",
"Pfxc5",
"Pfxc6",
"Pfxc7",
"Pfxc8",
"Pfxd1",
"Pfxd2",
"Pfxd3",
"Pfxd4",
"Pfxd5",
"Pfxd6",
"Pfxd7",
"Pfxd8",
"Pfxe1",
"Pfxe2",
"Pfxe3",
"Pfxe4",
"Pfxe5",
"Pfxe6",
"Pfxe7",
"Pfxe8",
"Pfxf1",
"Pfxf2",
"Pfxf3",
"Pfxf4",
"Pfxf5",
"Pfxf6",
"Pfxf7",
"Pfxf8",
"Sn1",
"Sn2",
"Sn3",
"Sn4",
"Sn5",
"Sn6",
"Sn7",
"Sn8",
"Sn9",
"Sn10",
"Sn11",
"Sn12",
"Sn13",
"Sn14",
"Sn15",
"Snx",
"Znx"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"saList": {
"description": "Service Action list. This SA list can be applied to an incoming digit string. Up to 8 SAs can be specified in the list. The SAs must be specified in high-to-low precedence order in the list, and cannot be duplicated in the list.",
"items": {
"enum" : [
"Asdlkup",
"Blklstqry",
"Blklstrly",
"Blnfndrls",
"Blrls",
"Cdial",
"Ccncchk",
"Cdpnnp",
"Cgpnasdrqd",
"Cgpngrnrqd",
"Cgpnnp",
"Cgpnrtg",
"Cgpnsvcrqd",
"Crp",
"Fpfxrls",
"Fraudchk",
"Fwdscs",
"Grnlkup",
"Inprtg",
"Lacck",
"Migrate",
"Nocgpnrls",
"Npnrls",
"Nprelay",
"Nprls",
"Nscgpn",
"Nscdpn",
"Pprelay",
"Rtdbtrn",
"Rtdbtsp",
"Rtdbtrnsp",
"Selscr",
"Skgtartg",
"Snscgpn",
"Tifgnbl",
"Tiflsbl",
"Tifrdnbl"
],
"type": "string"
},
"maxItems": 8,
"minItems": 0,
"type": "array"
},
"sa1dgts": {
"description": "Service Action 1 digit string. This parameter specifies a digit string that can be used with the first SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa2dgts": {
"description": "Service Action 2 digit string. This parameter specifies a digit string that can be used with the second SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa3dgts": {
"description": "Service Action 3 digit string. This parameter specifies a digit string that can be used with the third SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa4dgts": {
"description": "Service Action 4 digit string. This parameter specifies a digit string that can be used with the fourth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa5dgts": {
"description": "Service Action 5 digit string. This parameter specifies a digit string that can be used with the fifth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa6dgts": {
"description": "Service Action 6 digit string. This parameter specifies a digit string that can be used with the sixth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa7dgts": {
"description": "Service Action 7 digit string. This parameter specifies a digit string that can be used with the seventh SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa8dgts": {
"description": "Service Action 8 digit string. This parameter specifies a digit string that can be used with the eighth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa1val": {
"description": "Service Action 1 numerical values list. A comma-separated numerical values list that can be used with the first SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa2val": {
"description": "Service Action 2 numerical values list. A comma-separated numerical values list that can be used with the second SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa3val": {
"description": "Service Action 3 numerical values list. A comma-separated numerical values list that can be used with the third SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa4val": {
"description": "Service Action 4 numerical values list. A comma-separated numerical values list that can be used with the fourth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa5val": {
"description": "Service Action 5 numerical values list. A comma-separated numerical values list that can be used with the fifth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa6val": {
"description": "Service Action 6 numerical values list. A comma-separated numerical values list that can be used with the sixth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa7val": {
"description": "Service Action 7 numerical values list. A comma-separated numerical values list that can be used with the seventh SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa8val": {
"description": "Service Action 8 numerical values list. A comma-separated numerical values list that can be used with the eighth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"faList": {
"description": "Formatting Action list. This FA list can be applied to the outgoing digit string. Up to 12 FAs can be specified in the list. The FAs are processed in the order they are specified in the list and cannot be duplicated.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fane": {
"description": "Formatting Action list type Fane. Formatting Action List when the SP and RN entities are not associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fanf": {
"description": "Formatting Action list type Fanf. Formatting Action when the DN is not present in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"farn": {
"description": "Formatting Action list type Farn. Formatting Action List when the RN network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fasp": {
"description": "Formatting Action list type Fasp. Formatting Action List when the SP network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcd": {
"description": "Formatting Action list type Fascrcd. Formatting Action List to format ISUP CdPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcg": {
"description": "Formatting Action list type Fascrcg. Formatting Action List to format ISUP CgPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"ofnai": {
"description": "Outgoing filter nature of address indicator. The filter nature of address indicator (FNAI) class of the outgoing digit string.",
"enum" : [
"Intl",
"Natl",
"Nai1",
"Nai2",
"Nai3",
"Unkn",
"Inc"
],
"type": "string"
}
},
"required": ["actSetName"],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"actSetName": "ASN1",
"caList": [
"Cc1",
"Dn3"
],
"faList": [
"Cc"
],
"ofnai": "Inc",
"saList": [
"Blklstrly",
"Ccncchk",
"Nprelay"
]
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/nppactionsets/{name}
Updates the configuration of the specified NPP Action Set. If the provided NPP Action Set data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppactionset/nppactionset.json",
"properties": {
"actSetName": {
"description": "Action Set Name. This parameter specifies the name of the Action Set. Allowable values are 1 alphabetic character followed by up to 9 alphanumeric characters.",
"maxLength": 10,
"pattern": "^[a-zA-Z][a-zA-Z0-9]*$",
"type": "string"
},
"caList": {
"description": "Conditioning Action list. This CA list can be applied to an incoming digit string. Up to 12 CAs can be specified in the list. The CAs are processed in the order they are specified in the list.",
"items": {
"enum" : [
"Ac1",
"Ac2",
"Ac3",
"Ac4",
"Ac5",
"Ac6",
"Ac7",
"Ac8",
"Accgpn",
"Accgpn1",
"Accgpn2",
"Accgpn3",
"Accgpn4",
"Accgpn5",
"Accgpn6",
"Accgpn7",
"Accgpn8",
"Acdef",
"Aclac",
"Cc1",
"Cc2",
"Cc3",
"Ccdef",
"Cccgpn",
"Dn1",
"Dn2",
"Dn3",
"Dn4",
"Dn5",
"Dn6",
"Dn7",
"Dn8",
"Dn9",
"Dn10",
"Dn11",
"Dn12",
"Dn13",
"Dn14",
"Dn15",
"Dnx",
"Fpfx",
"Ign1",
"Ign2",
"Ign3",
"Ign4",
"Ign5",
"Ign6",
"Ign7",
"Ign8",
"Ign9",
"Ign10",
"Pfxa1",
"Pfxa2",
"Pfxa3",
"Pfxa4",
"Pfxa5",
"Pfxa6",
"Pfxa7",
"Pfxa8",
"Pfxb1",
"Pfxb2",
"Pfxb3",
"Pfxb4",
"Pfxb5",
"Pfxb6",
"Pfxb7",
"Pfxb8",
"Pfxc1",
"Pfxc2",
"Pfxc3",
"Pfxc4",
"Pfxc5",
"Pfxc6",
"Pfxc7",
"Pfxc8",
"Pfxd1",
"Pfxd2",
"Pfxd3",
"Pfxd4",
"Pfxd5",
"Pfxd6",
"Pfxd7",
"Pfxd8",
"Pfxe1",
"Pfxe2",
"Pfxe3",
"Pfxe4",
"Pfxe5",
"Pfxe6",
"Pfxe7",
"Pfxe8",
"Pfxf1",
"Pfxf2",
"Pfxf3",
"Pfxf4",
"Pfxf5",
"Pfxf6",
"Pfxf7",
"Pfxf8",
"Sn1",
"Sn2",
"Sn3",
"Sn4",
"Sn5",
"Sn6",
"Sn7",
"Sn8",
"Sn9",
"Sn10",
"Sn11",
"Sn12",
"Sn13",
"Sn14",
"Sn15",
"Snx",
"Znx"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"saList": {
"description": "Service Action list. This SA list can be applied to an incoming digit string. Up to 8 SAs can be specified in the list. The SAs must be specified in high-to-low precedence order in the list, and cannot be duplicated in the list.",
"items": {
"enum" : [
"Asdlkup",
"Blklstqry",
"Blklstrly",
"Blnfndrls",
"Blrls",
"Cdial",
"Ccncchk",
"Cdpnnp",
"Cgpnasdrqd",
"Cgpngrnrqd",
"Cgpnnp",
"Cgpnrtg",
"Cgpnsvcrqd",
"Crp",
"Fpfxrls",
"Fraudchk",
"Fwdscs",
"Grnlkup",
"Inprtg",
"Lacck",
"Migrate",
"Nocgpnrls",
"Npnrls",
"Nprelay",
"Nprls",
"Nscgpn",
"Nscdpn",
"Pprelay",
"Rtdbtrn",
"Rtdbtsp",
"Rtdbtrnsp",
"Selscr",
"Skgtartg",
"Snscgpn",
"Tifgnbl",
"Tiflsbl",
"Tifrdnbl"
],
"type": "string"
},
"maxItems": 8,
"minItems": 0,
"type": "array"
},
"sa1dgts": {
"description": "Service Action 1 digit string. This parameter specifies a digit string that can be used with the first SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa2dgts": {
"description": "Service Action 2 digit string. This parameter specifies a digit string that can be used with the second SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa3dgts": {
"description": "Service Action 3 digit string. This parameter specifies a digit string that can be used with the third SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa4dgts": {
"description": "Service Action 4 digit string. This parameter specifies a digit string that can be used with the fourth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa5dgts": {
"description": "Service Action 5 digit string. This parameter specifies a digit string that can be used with the fifth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa6dgts": {
"description": "Service Action 6 digit string. This parameter specifies a digit string that can be used with the sixth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa7dgts": {
"description": "Service Action 7 digit string. This parameter specifies a digit string that can be used with the seventh SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa8dgts": {
"description": "Service Action 8 digit string. This parameter specifies a digit string that can be used with the eighth SA.",
"maxLength": 8,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"sa1val": {
"description": "Service Action 1 numerical values list. A comma-separated numerical values list that can be used with the first SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa2val": {
"description": "Service Action 2 numerical values list. A comma-separated numerical values list that can be used with the second SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa3val": {
"description": "Service Action 3 numerical values list. A comma-separated numerical values list that can be used with the third SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa4val": {
"description": "Service Action 4 numerical values list. A comma-separated numerical values list that can be used with the fourth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa5val": {
"description": "Service Action 5 numerical values list. A comma-separated numerical values list that can be used with the fifth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa6val": {
"description": "Service Action 6 numerical values list. A comma-separated numerical values list that can be used with the sixth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa7val": {
"description": "Service Action 7 numerical values list. A comma-separated numerical values list that can be used with the seventh SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"sa8val": {
"description": "Service Action 8 numerical values list. A comma-separated numerical values list that can be used with the eighth SA.",
"items": {
"maximum": 65534,
"minimum": 0,
"type": "integer"
},
"maxItems": 2,
"minItems": 0,
"type": "array"
},
"faList": {
"description": "Formatting Action list. This FA list can be applied to the outgoing digit string. Up to 12 FAs can be specified in the list. The FAs are processed in the order they are specified in the list and cannot be duplicated.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fane": {
"description": "Formatting Action list type Fane. Formatting Action List when the SP and RN entities are not associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fanf": {
"description": "Formatting Action list type Fanf. Formatting Action when the DN is not present in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"farn": {
"description": "Formatting Action list type Farn. Formatting Action List when the RN network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fasp": {
"description": "Formatting Action list type Fasp. Formatting Action List when the SP network entity is associated with the DN in the RTDB.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcd": {
"description": "Formatting Action list type Fascrcd. Formatting Action List to format ISUP CdPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"fascrcg": {
"description": "Formatting Action list type Fascrcg. Formatting Action List to format ISUP CgPN digits when CdPN is Screened and SA(X)VAL is none.",
"items": {
"enum" : [
"Ac",
"Asd",
"Asdother",
"Cc",
"Dlma",
"Dlmb",
"Dlmc",
"Dlmd",
"Dlme",
"Dlmf",
"Dlmg",
"Dlmh",
"Dlmi",
"Dlmj",
"Dlmk",
"Dlml",
"Dlmm",
"Dlmn",
"Dlmo",
"Dlmp",
"Dn",
"Fpfx",
"Grn",
"Grnother",
"Orig",
"Pfxa",
"Pfxb",
"Pfxc",
"Pfxd",
"Pfxe",
"Pfxf",
"Rn",
"Rnospodn",
"Rnosposn",
"Rnospozn",
"Sn",
"Sp",
"Srfimsi",
"Vmid",
"Zn"
],
"type": "string"
},
"maxItems": 12,
"minItems": 0,
"type": "array"
},
"ofnai": {
"description": "Outgoing filter nature of address indicator. The filter nature of address indicator (FNAI) class of the outgoing digit string.",
"enum" : [
"Intl",
"Natl",
"Nai1",
"Nai2",
"Nai3",
"Unkn",
"Inc"
],
"type": "string"
}
},
"required": ["actSetName"],
"type": "object"
}
Example
{
"actSetName": "ASN1",
"caList": [
"Cc1",
"Dn3"
],
"faList": [
"Cc"
],
"ofnai": "Inc",
"saList": [
"Blklstrly",
"Ccncchk",
"Nprelay"
]
}
delete /vstp/nppactionsets/{name}
Deletes the specified NPP Action Set from the SOAM configuration. An attempt to delete a NPP Action Set which does not exist results in an error message returned within the HTTP response. NPP Action Set cannot be removed if already used by NPP Service Rule Set.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: NPP services
Numbering Plan Processor (NPP) service entry uses the NPP to assist with the processing of digit strings. There is a single instance for each of the services of this resource, which contains each of the individual attributes that can be retrieved and set. A collection of GET is supported as we have multiple pre-configured services. No new NPP service resource can be created, so there is no POST action, and the single instance for each services cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options for each services, and PUT is used to update one or more values within the set of options for each resources.
All NPP service configuration is done at the SOAM.
/vstp/nppservices
get /vstp/nppservices
Returns the set of current values for the NPP service.
Target Server: SOAM
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/nppserviceCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppservice/nppservice.json",
"properties": {
"dlma": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmb": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmc": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmd": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlme": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmf": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmg": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmh": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmi": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmj": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmk": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlml": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmm": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmn": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmo": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmp": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"intl": {
"description": "International. This parameter maps an International FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"nai1": {
"description": "This parameter maps an NAI-1 FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"nai2": {
"description": "This parameter maps an NAI-2 FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"nai3": {
"description": "This parameter maps an NAI-3 FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"natl": {
"description": "This parameter maps a National FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"ruleCount": {
"description": "This parameter configures count of NPP Rules.",
"maximum": 4096,
"minimum": 0,
"default": 0,
"type": "integer"
},
"srvn": {
"description": "Service name. The name of the NPP Service.The SA and Precedence of the services are (#1#) The SA and Precedence of Idprcdpn Service (i.e Idprcdpn, Idprcdpn2, Idprcdpn3, Idprcdpn4) is ccncchk->100, inprtg->95, cdpnnp->80, lacck->60, cgpnsvcrqd-> 60, asdlkup->50, grnlkup->50, cgpnasdrqd->50, cgpngrnrqd->50, inprtg->95, skgtartg->50 cdial->10. (#2#) The SA and Precedence of Idprcgpn service is inprtg->95, blklstqry->90, blklstrly->90, cgpnnp->80, cgpnrtg->70, asdlkup>50, grnlkup->50, cdial->10. (#3#) The SA and precedence of Mosmsgcdpnservice is pprelay->80, cdpnnp->60, asdlkup->50, grnlkup->50, cgpnasdrqd->50, cgpngrnrqd->50, cdial->10. (#4#) The SA and Precedence of Mosmsgcgpn service is fraudchk->90, pprelay->80, asdlkup->50, grnlkup->50, cdial->10. (#5#) The SA and Precedence of Tif Cdpn Service (i.e Tif, Tif2, Tif3) is crp->92, fpfxrls->92, blrls->91, blnfndrls->91, selscr->91, npnrls->91, asdlkup->90, cgpnasdrqd->90, grnlkup->90, cgpngrnrqd->90, tifrdnbl->90, cgpnsvcrqd->80, nprelay->80, nprls->80, nocgpnrls->80, nscdpn->80, snscgpn->75, nscgpn->75, cdial->10, fwdscs->5 (#6#) The SA and Precedence of Tifcgpn service (i.e Tifcgpn, Tifcgpn2, Tifcgpn3) is fpfxrls->92, blrls->91, blnfndrls->91, tiflsbl->91, asdlkup->90, grnlkup->90, tifgnbl->90, cgpnnp->80, snscgpn->75, nscgpn->75, cdial->10.",
"enum" : [
"Idprcdpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Idprcgpn",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Tif",
"Tif2",
"Tif3",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"type": "string"
},
"status": {
"description": "This parameter specifies whether the service can be processed by the NPP.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"sdwcCount": {
"description": "This parameter configures count of SDWC.",
"maximum": 25,
"minimum": 0,
"default": 0,
"type": "integer"
},
"unkn": {
"description": "This parameter maps an Unknown FNAI class to the NAI of the incoming digit string.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": ["srvn"],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"dlma": "None",
"dlmb": "aef",
"dlmc": "aef",
"dlmd": "aef",
"dlme": "aef",
"dlmf": "aef",
"dlmg": "aef",
"dlmh": "aef",
"dlmi": "aef",
"dlmj": "aef",
"dlmk": "aef",
"dlml": "aef",
"dlmm": "aef",
"dlmn": "aef",
"dlmo": "aef",
"dlmp": "None",
"intl": "5",
"nai1": "6",
"nai1": "7",
"nai2": "8",
"nai3": "9",
"natl": "10",
"ruleCount": 1,
"srvn": "Mosmsgcdpn",
"status": "Off",
"sdwcCount": 3,
"unkn": "10"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/nppservices
Update the NPP service with the values supplied for specified service. If the provided NPP service data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppservice/nppservice.json",
"properties": {
"dlma": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmb": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmc": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmd": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlme": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmf": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmg": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmh": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmi": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmj": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmk": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlml": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmm": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmn": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmo": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmp": {
"description": "A delimiter that is used to format the outgoing dialed number.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"intl": {
"description": "International. This parameter maps an International FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"nai1": {
"description": "This parameter maps an NAI-1 FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"nai2": {
"description": "This parameter maps an NAI-2 FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"nai3": {
"description": "This parameter maps an NAI-3 FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"natl": {
"description": "This parameter maps a National FNAI class to the NAI of the incoming digit string.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$|^(None)$",
"default": "None",
"type": "string"
},
"ruleCount": {
"description": "This parameter configures count of NPP Rules.",
"maximum": 4096,
"minimum": 0,
"default": 0,
"type": "integer"
},
"srvn": {
"description": "Service name. The name of the NPP Service.The SA and Precedence of the services are (#1#) The SA and Precedence of Idprcdpn Service (i.e Idprcdpn, Idprcdpn2, Idprcdpn3, Idprcdpn4) is ccncchk->100, inprtg->95, cdpnnp->80, lacck->60, cgpnsvcrqd-> 60, asdlkup->50, grnlkup->50, cgpnasdrqd->50, cgpngrnrqd->50, inprtg->95, skgtartg->50 cdial->10. (#2#) The SA and Precedence of Idprcgpn service is inprtg->95, blklstqry->90, blklstrly->90, cgpnnp->80, cgpnrtg->70, asdlkup>50, grnlkup->50, cdial->10. (#3#) The SA and precedence of Mosmsgcdpnservice is pprelay->80, cdpnnp->60, asdlkup->50, grnlkup->50, cgpnasdrqd->50, cgpngrnrqd->50, cdial->10. (#4#) The SA and Precedence of Mosmsgcgpn service is fraudchk->90, pprelay->80, asdlkup->50, grnlkup->50, cdial->10. (#5#) The SA and Precedence of Tif Cdpn Service (i.e Tif, Tif2, Tif3) is crp->92, fpfxrls->92, blrls->91, blnfndrls->91, selscr->91, npnrls->91, asdlkup->90, cgpnasdrqd->90, grnlkup->90, cgpngrnrqd->90, tifrdnbl->90, cgpnsvcrqd->80, nprelay->80, nprls->80, nocgpnrls->80, nscdpn->80, snscgpn->75, nscgpn->75, cdial->10, fwdscs->5 (#6#) The SA and Precedence of Tifcgpn service (i.e Tifcgpn, Tifcgpn2, Tifcgpn3) is fpfxrls->92, blrls->91, blnfndrls->91, tiflsbl->91, asdlkup->90, grnlkup->90, tifgnbl->90, cgpnnp->80, snscgpn->75, nscgpn->75, cdial->10.",
"enum" : [
"Idprcdpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Idprcgpn",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Tif",
"Tif2",
"Tif3",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"type": "string"
},
"status": {
"description": "This parameter specifies whether the service can be processed by the NPP.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"sdwcCount": {
"description": "This parameter configures count of SDWC.",
"maximum": 25,
"minimum": 0,
"default": 0,
"type": "integer"
},
"unkn": {
"description": "This parameter maps an Unknown FNAI class to the NAI of the incoming digit string.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
}
},
"required": ["srvn"],
"type": "object"
}
Example
{
"dlma": "None",
"dlmb": "aef",
"dlmc": "aef",
"dlmd": "aef",
"dlme": "aef",
"dlmf": "aef",
"dlmg": "aef",
"dlmh": "aef",
"dlmi": "aef",
"dlmj": "aef",
"dlmk": "aef",
"dlml": "aef",
"dlmm": "aef",
"dlmn": "aef",
"dlmo": "aef",
"dlmp": "None",
"intl": "5",
"nai1": "6",
"nai1": "7",
"nai2": "8",
"nai3": "9",
"natl": "10",
"ruleCount": 1,
"srvn": "Mosmsgcdpn",
"status": "Off",
"sdwcCount": 3,
"unkn": "10"
}
Vstp: Npp Service Rule Sets
A NPP Service Rule Set (SRS) is a collection of NPP Rules that are associated with a NPP Service (/vstp/nppservices). A NPP Rule is an association between a single NPP filter and a single NPP Action Set(/vstp/nppactionsets).
All configuration of NPP Service Rule Set is done at the SOAM.
/vstp/nppservicerulesets
get /vstp/nppservicerulesets
Returns all Npp Service Rule Sets that meet the criteria specified in the GET request. By default, all Npp Service Rule Sets configured at the SOAM are returned. If paging parameters are supplied, only those Npp Service Rule Set meeting the request parameters are returned. In case, wildcard(?) is used in fpfx parameter which makes uniqueIdentifier, then use %3F in place of wildcard(?) in MMI URL. e.g.- For GET action of record with uniqueIdentifier "Mosmsgcdpn-Intl-a?a-29", MMI URL will be mmiclient.py /vstp/nppservicerulesets/"Mosmsgcdpn-Intl-a%3Fa-29" .
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=srvn
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=srvn
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/nppservicerulesetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppserviceruleset/nppserviceruleset.json",
"properties": {
"srvn": {
"description": "Service name. The name of the NPP (Numbering Plan Processor) service.",
"enum" : [
"Idprcdpn",
"Idprcgpn",
"Tif",
"Tif2",
"Tif3",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"type": "string"
},
"fnai": {
"description": "Filter nature of address indicator. The filter Nature of Address Indicator (NAI) class.",
"enum" : [
"Unkn",
"Intl",
"Natl",
"Nai1",
"Nai2",
"Nai3"
],
"type": "string"
},
"fpfx": {
"description": "Filter prefix. The prefix used to filter incoming digit strings.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^([A-Fa-f0-9]*(\\?){0,15}[a-fA-F0-9])*$|^(\\*)$",
"type": "string"
},
"fdl": {
"description": "Filter digit length. This parameter specifies the number of digits on the incoming digit string that is filtered by the NPP.",
"maxLength": 2,
"pattern": "^([1-9]|[1-2][0-9]|[3][0-2]|\\*)$",
"type": "string"
},
"asn": {
"description": "Action set name. This parameter specifies the name of the AS. Allowable values are 1 alphabetic character followed by up to 9 alphanumeric characters.",
"maxLength": 10,
"pattern": "^([a-zA-Z][a-zA-Z0-9]*)$",
"type": "string"
},
"invkserv": {
"description": "Invoke service name. The name of the NPP service to be invoked.",
"enum" : [
"None",
"Idprcdpn",
"Idprcgpn",
"Tif",
"Tif2",
"Tif3",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"default": "None",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this npp service rule set. The unique identifier value is a combination of srvn, fnai, fpfx and ddl",
"readOnly": true,
"pattern": "^((Idprcdpn|Idprcgpn|Tif|Tif2|Tif3|Mosmsgcdpn|Mosmsgcgpn|Idprcdpn2|Idprcdpn3|Idprcdpn4|Tifcgpn|Tifcgpn2|Tifcgpn3)(-)(Unkn|Intl|Natl|Nai1|Nai2|Nai3)(-)(([a-fA-F0-9]*)|([A-Fa-f0-9]*(\\?){0,15}[a-fA-F0-9])*|(\\*))(-)([0-9]*)(\\*)?)$",
"type": "string"
}
},
"required": ["srvn", "asn", "fnai", "fpfx", "fdl"],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"asn": "asn1",
"fdl": "29",
"fnai": "Intl",
"fpfx": "A1",
"invkserv": "Nppt",
"srvn": "Nppt"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/nppservicerulesets
Adds a new Npp Service Rule Set to the VSTP configuration. The Npp Service Rule Set name must be unique across all Npp Service Rule Sets at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppserviceruleset/nppserviceruleset.json",
"properties": {
"srvn": {
"description": "Service name. The name of the NPP (Numbering Plan Processor) service.",
"enum" : [
"Idprcdpn",
"Idprcgpn",
"Tif",
"Tif2",
"Tif3",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"type": "string"
},
"fnai": {
"description": "Filter nature of address indicator. The filter Nature of Address Indicator (NAI) class.",
"enum" : [
"Unkn",
"Intl",
"Natl",
"Nai1",
"Nai2",
"Nai3"
],
"type": "string"
},
"fpfx": {
"description": "Filter prefix. The prefix used to filter incoming digit strings.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^([A-Fa-f0-9]*(\\?){0,15}[a-fA-F0-9])*$|^(\\*)$",
"type": "string"
},
"fdl": {
"description": "Filter digit length. This parameter specifies the number of digits on the incoming digit string that is filtered by the NPP.",
"maxLength": 2,
"pattern": "^([1-9]|[1-2][0-9]|[3][0-2]|\\*)$",
"type": "string"
},
"asn": {
"description": "Action set name. This parameter specifies the name of the AS. Allowable values are 1 alphabetic character followed by up to 9 alphanumeric characters.",
"maxLength": 10,
"pattern": "^([a-zA-Z][a-zA-Z0-9]*)$",
"type": "string"
},
"invkserv": {
"description": "Invoke service name. The name of the NPP service to be invoked.",
"enum" : [
"None",
"Idprcdpn",
"Idprcgpn",
"Tif",
"Tif2",
"Tif3",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"default": "None",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this npp service rule set. The unique identifier value is a combination of srvn, fnai, fpfx and ddl",
"readOnly": true,
"pattern": "^((Idprcdpn|Idprcgpn|Tif|Tif2|Tif3|Mosmsgcdpn|Mosmsgcgpn|Idprcdpn2|Idprcdpn3|Idprcdpn4|Tifcgpn|Tifcgpn2|Tifcgpn3)(-)(Unkn|Intl|Natl|Nai1|Nai2|Nai3)(-)(([a-fA-F0-9]*)|([A-Fa-f0-9]*(\\?){0,15}[a-fA-F0-9])*|(\\*))(-)([0-9]*)(\\*)?)$",
"type": "string"
}
},
"required": ["srvn", "asn", "fnai", "fpfx", "fdl"],
"type": "object"
}
Example
{
"asn": "asn1",
"fdl": "29",
"fnai": "Intl",
"fpfx": "A1",
"invkserv": "Nppt",
"srvn": "Nppt"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/nppservicerulesets/{uniqueIdentifier}
get /vstp/nppservicerulesets/{uniqueIdentifier}
Returns the configuration details for the specified Npp Service Rule Set. If the Npp Service Rule Set does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/nppservicerulesetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/nppserviceruleset/nppserviceruleset.json",
"properties": {
"srvn": {
"description": "Service name. The name of the NPP (Numbering Plan Processor) service.",
"enum" : [
"Idprcdpn",
"Idprcgpn",
"Tif",
"Tif2",
"Tif3",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"type": "string"
},
"fnai": {
"description": "Filter nature of address indicator. The filter Nature of Address Indicator (NAI) class.",
"enum" : [
"Unkn",
"Intl",
"Natl",
"Nai1",
"Nai2",
"Nai3"
],
"type": "string"
},
"fpfx": {
"description": "Filter prefix. The prefix used to filter incoming digit strings.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^([A-Fa-f0-9]*(\\?){0,15}[a-fA-F0-9])*$|^(\\*)$",
"type": "string"
},
"fdl": {
"description": "Filter digit length. This parameter specifies the number of digits on the incoming digit string that is filtered by the NPP.",
"maxLength": 2,
"pattern": "^([1-9]|[1-2][0-9]|[3][0-2]|\\*)$",
"type": "string"
},
"asn": {
"description": "Action set name. This parameter specifies the name of the AS. Allowable values are 1 alphabetic character followed by up to 9 alphanumeric characters.",
"maxLength": 10,
"pattern": "^([a-zA-Z][a-zA-Z0-9]*)$",
"type": "string"
},
"invkserv": {
"description": "Invoke service name. The name of the NPP service to be invoked.",
"enum" : [
"None",
"Idprcdpn",
"Idprcgpn",
"Tif",
"Tif2",
"Tif3",
"Mosmsgcdpn",
"Mosmsgcgpn",
"Idprcdpn2",
"Idprcdpn3",
"Idprcdpn4",
"Tifcgpn",
"Tifcgpn2",
"Tifcgpn3"
],
"default": "None",
"type": "string"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for this npp service rule set. The unique identifier value is a combination of srvn, fnai, fpfx and ddl",
"readOnly": true,
"pattern": "^((Idprcdpn|Idprcgpn|Tif|Tif2|Tif3|Mosmsgcdpn|Mosmsgcgpn|Idprcdpn2|Idprcdpn3|Idprcdpn4|Tifcgpn|Tifcgpn2|Tifcgpn3)(-)(Unkn|Intl|Natl|Nai1|Nai2|Nai3)(-)(([a-fA-F0-9]*)|([A-Fa-f0-9]*(\\?){0,15}[a-fA-F0-9])*|(\\*))(-)([0-9]*)(\\*)?)$",
"type": "string"
}
},
"required": ["srvn", "asn", "fnai", "fpfx", "fdl"],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"asn": "asn1",
"fdl": "29",
"fnai": "Intl",
"fpfx": "A1",
"invkserv": "Nppt",
"srvn": "Nppt"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/nppservicerulesets/{uniqueIdentifier}
Update the nppserviceruleset
Secured by x-other
delete /vstp/nppservicerulesets/{uniqueIdentifier}
Deletes the specified Npp Service Rule Set from the SOAM configuration. A Npp Service Rule Set can only be deleted if all delete validation checks pass. An attempt to delete a Npp Service Rule Set that cannot be deleted results in an error message returned within the HTTP response. In case, wildcard(?) is used in fpfx parameter which makes uniqueIdentifier, then use %3F in place of wildcard(?) in MMI URL. e.g.- For DELETE action of record with uniqueIdentifier "Mosmsgcdpn-Intl-a?a-29", MMI URL will be mmiclient.py /vstp/nppservicerulesets/"Mosmsgcdpn-Intl-a%3Fa-29" -v DELETE.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- uniqueIdentifier: required (string)
Vstp: PPS Relays
Prepaid Short Message Service relays (PPSRELAY). This creates the PPSOPTS entries that correspond to Intelligent Network (IN) platforms.
All configuration of the PPS Relays is done at the SOAM.
/vstp/ppsrelays
get /vstp/ppsrelays
Returns all PPS Relays that meet the criteria specified in the GET request. By default, all PPS Relays configured at the SOAM are returned. If paging parameters are supplied, only those PPS Relays meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/ppsrelayCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/ppsrelay/ppsrelay.json",
"properties": {
"gta": {
"description": "Global title address. The entity address for an IN platform. Determines whether an incoming message receives PPSMS screening.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"setId": {
"description": "Set ID. The MAP set ID (if the ri=Ssn parameter is specified) or the MRN set ID (if the ri=Gt parameter is specified) that is used by a loadsharing IN platform.",
"maxLength": 5,
"pattern": "^(?!(0+)$)^(([0-2]?[0-9]{0,4})|(3[0-5][0-9]{0,3})|(36000))$|^(None)$",
"type": "string"
},
"ri": {
"description": "Routing indicator. The IN platform routing indicator.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ppt": {
"description": "Prepaid portability type. The IN platform where the incoming message is sent.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"ssn": {
"description": "The Subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
}
},
"required": [],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"ppt": 10,
"ri": "Ssn",
"rspName": "RSP1",
"setId": "100",
"ssn": 5
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/ppsrelays
Adds a new PPS Relay to the VSTP configuration. The PPT and GTA value must be unique across all PPS Relays at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/ppsrelay/ppsrelay.json",
"properties": {
"gta": {
"description": "Global title address. The entity address for an IN platform. Determines whether an incoming message receives PPSMS screening.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"setId": {
"description": "Set ID. The MAP set ID (if the ri=Ssn parameter is specified) or the MRN set ID (if the ri=Gt parameter is specified) that is used by a loadsharing IN platform.",
"maxLength": 5,
"pattern": "^(?!(0+)$)^(([0-2]?[0-9]{0,4})|(3[0-5][0-9]{0,3})|(36000))$|^(None)$",
"type": "string"
},
"ri": {
"description": "Routing indicator. The IN platform routing indicator.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ppt": {
"description": "Prepaid portability type. The IN platform where the incoming message is sent.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"ssn": {
"description": "The Subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
}
},
"required": [],
"type": "object"
}
Example
{
"ppt": 10,
"ri": "Ssn",
"rspName": "RSP1",
"setId": "100",
"ssn": 5
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/ppsrelays/ppt:{value}
get /vstp/ppsrelays/ppt:{value}
Returns the configuration details for the specified PPS Relay. If the PPS Relay does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- value: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/ppsrelayItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/ppsrelay/ppsrelay.json",
"properties": {
"gta": {
"description": "Global title address. The entity address for an IN platform. Determines whether an incoming message receives PPSMS screening.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"setId": {
"description": "Set ID. The MAP set ID (if the ri=Ssn parameter is specified) or the MRN set ID (if the ri=Gt parameter is specified) that is used by a loadsharing IN platform.",
"maxLength": 5,
"pattern": "^(?!(0+)$)^(([0-2]?[0-9]{0,4})|(3[0-5][0-9]{0,3})|(36000))$|^(None)$",
"type": "string"
},
"ri": {
"description": "Routing indicator. The IN platform routing indicator.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ppt": {
"description": "Prepaid portability type. The IN platform where the incoming message is sent.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"ssn": {
"description": "The Subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ppt": 10,
"ri": "Ssn",
"rspName": "RSP1",
"setId": "100",
"ssn": 5
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/ppsrelays/ppt:{value}
delete /vstp/ppsrelays/ppt:{value}
Deletes the specified PPS Relay from the SOAM configuration. To delete an entry user has to specify the identifier name [ppt, gta] and the value separated by a colon (:). An attempt to delete a PPS Relay which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- value: required (string)
/vstp/ppsrelays/gta:{value}
get /vstp/ppsrelays/gta:{value}
Returns the configuration details for the specified PPS Relay. If the PPS Relay does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- value: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/ppsrelayItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/ppsrelay/ppsrelay.json",
"properties": {
"gta": {
"description": "Global title address. The entity address for an IN platform. Determines whether an incoming message receives PPSMS screening.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"setId": {
"description": "Set ID. The MAP set ID (if the ri=Ssn parameter is specified) or the MRN set ID (if the ri=Gt parameter is specified) that is used by a loadsharing IN platform.",
"maxLength": 5,
"pattern": "^(?!(0+)$)^(([0-2]?[0-9]{0,4})|(3[0-5][0-9]{0,3})|(36000))$|^(None)$",
"type": "string"
},
"ri": {
"description": "Routing indicator. The IN platform routing indicator.",
"enum": [
"Gt",
"Ssn"
],
"type": "string"
},
"rspName": {
"description": "Defines the Remote Signaling Point name.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"ppt": {
"description": "Prepaid portability type. The IN platform where the incoming message is sent.",
"maximum": 32,
"minimum": 1,
"type": "integer"
},
"ssn": {
"description": "The Subsystem number.",
"maximum": 255,
"minimum": 2,
"type": "integer"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"ppt": 10,
"ri": "Ssn",
"rspName": "RSP1",
"setId": "100",
"ssn": 5
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/ppsrelays/gta:{value}
delete /vstp/ppsrelays/gta:{value}
Deletes the specified PPS Relay from the SOAM configuration. To delete an entry user has to specify the identifier name [ppt, gta] and the value separated by a colon (:). An attempt to delete a PPS Relay which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- value: required (string)
Vstp: Mtp2 Timer Set Configs
A Mtp2 Config is an entity to configure all the mtp2 timers.
All configuration of Mtp2 Config is done at the SOAM.
/vstp/mtp2timersetconfigs
get /vstp/mtp2timersetconfigs
Returns all Mtp2 Configs that meet the criteria specified in the GET request. By default, all Mtp2 Configs configured at the SOAM are returned. If paging parameters are supplied, only those Mtp2 Configs meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mtp2configCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t1Timer": {
"description": "Alignment Ready timer. The amount of time (in milliseconds) MTP2 waits to receive a Link Status Ready message from the peer. Typical value is 9000.",
"maximum": 350000,
"minimum": 5000,
"type": "integer"
},
"t2Timer": {
"description": "Not Aligned timer.Typical value is 9000",
"maximum": 480000,
"minimum": 5000,
"type": "integer"
},
"t3Timer": {
"description": "Alignment timer. The amount of time (in milliseconds) MTP2 waits to receive Link Status Proving message from the peer. Typical value is 9000.",
"maximum": 20000,
"minimum": 1000,
"type": "integer"
},
"t4EmergencyTimer": {
"description": "Emergency proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during emergency proving. Typical value is 600.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"t4NormalTimer": {
"description": "Normal proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during normal proving. Typical value is 2300.",
"maximum": 70000,
"minimum": 500,
"type": "integer"
},
"t5Timer": {
"description": "Sending SIB timer. Typical value is 90.",
"maximum": 500,
"minimum": 40,
"type": "integer"
},
"t6Timer": {
"description": "Remote congestion timer. The amount of time (in milliseconds) that a congested link will remain in service. Typical value is 4000.",
"maximum": 10000,
"minimum": 1000,
"type": "integer"
},
"t7Timer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 300.",
"maximum": 3000,
"minimum": 200,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"name": "mtp2Conf1",
"t1Timer": 9000,
"t2Timer": 9000,
"t3Timer": 9000,
"t4EmergencyTimer": 600,
"t4NormalTimer": 2300,
"t5Timer": 90,
"t6Timer": 4000,
"t7Timer": 300
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/mtp2timersetconfigs
Adds a new Mtp2 Config to the VSTP configuration. If the provided Mtp2 Config data is invalid in any way, the insert fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t1Timer": {
"description": "Alignment Ready timer. The amount of time (in milliseconds) MTP2 waits to receive a Link Status Ready message from the peer. Typical value is 9000.",
"maximum": 350000,
"minimum": 5000,
"type": "integer"
},
"t2Timer": {
"description": "Not Aligned timer.Typical value is 9000",
"maximum": 480000,
"minimum": 5000,
"type": "integer"
},
"t3Timer": {
"description": "Alignment timer. The amount of time (in milliseconds) MTP2 waits to receive Link Status Proving message from the peer. Typical value is 9000.",
"maximum": 20000,
"minimum": 1000,
"type": "integer"
},
"t4EmergencyTimer": {
"description": "Emergency proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during emergency proving. Typical value is 600.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"t4NormalTimer": {
"description": "Normal proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during normal proving. Typical value is 2300.",
"maximum": 70000,
"minimum": 500,
"type": "integer"
},
"t5Timer": {
"description": "Sending SIB timer. Typical value is 90.",
"maximum": 500,
"minimum": 40,
"type": "integer"
},
"t6Timer": {
"description": "Remote congestion timer. The amount of time (in milliseconds) that a congested link will remain in service. Typical value is 4000.",
"maximum": 10000,
"minimum": 1000,
"type": "integer"
},
"t7Timer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 300.",
"maximum": 3000,
"minimum": 200,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "mtp2Conf1",
"t1Timer": 9000,
"t2Timer": 9000,
"t3Timer": 9000,
"t4EmergencyTimer": 600,
"t4NormalTimer": 2300,
"t5Timer": 90,
"t6Timer": 4000,
"t7Timer": 300
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/mtp2timersetconfigs/{name}
get /vstp/mtp2timersetconfigs/{name}
Returns the configuration details for the specified Mtp2 Config. If the Mtp2 Config does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mtp2configItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t1Timer": {
"description": "Alignment Ready timer. The amount of time (in milliseconds) MTP2 waits to receive a Link Status Ready message from the peer. Typical value is 9000.",
"maximum": 350000,
"minimum": 5000,
"type": "integer"
},
"t2Timer": {
"description": "Not Aligned timer.Typical value is 9000",
"maximum": 480000,
"minimum": 5000,
"type": "integer"
},
"t3Timer": {
"description": "Alignment timer. The amount of time (in milliseconds) MTP2 waits to receive Link Status Proving message from the peer. Typical value is 9000.",
"maximum": 20000,
"minimum": 1000,
"type": "integer"
},
"t4EmergencyTimer": {
"description": "Emergency proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during emergency proving. Typical value is 600.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"t4NormalTimer": {
"description": "Normal proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during normal proving. Typical value is 2300.",
"maximum": 70000,
"minimum": 500,
"type": "integer"
},
"t5Timer": {
"description": "Sending SIB timer. Typical value is 90.",
"maximum": 500,
"minimum": 40,
"type": "integer"
},
"t6Timer": {
"description": "Remote congestion timer. The amount of time (in milliseconds) that a congested link will remain in service. Typical value is 4000.",
"maximum": 10000,
"minimum": 1000,
"type": "integer"
},
"t7Timer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 300.",
"maximum": 3000,
"minimum": 200,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"name": "mtp2Conf1",
"t1Timer": 9000,
"t2Timer": 9000,
"t3Timer": 9000,
"t4EmergencyTimer": 600,
"t4NormalTimer": 2300,
"t5Timer": 90,
"t6Timer": 4000,
"t7Timer": 300
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/mtp2timersetconfigs/{name}
Updates the configuration of the specified Mtp2 Config. If the provided Mtp2 Config data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2config/mtp2config.json",
"properties": {
"name": {
"description": "Name for this Mtp2 Config, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"t1Timer": {
"description": "Alignment Ready timer. The amount of time (in milliseconds) MTP2 waits to receive a Link Status Ready message from the peer. Typical value is 9000.",
"maximum": 350000,
"minimum": 5000,
"type": "integer"
},
"t2Timer": {
"description": "Not Aligned timer.Typical value is 9000",
"maximum": 480000,
"minimum": 5000,
"type": "integer"
},
"t3Timer": {
"description": "Alignment timer. The amount of time (in milliseconds) MTP2 waits to receive Link Status Proving message from the peer. Typical value is 9000.",
"maximum": 20000,
"minimum": 1000,
"type": "integer"
},
"t4EmergencyTimer": {
"description": "Emergency proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during emergency proving. Typical value is 600.",
"maximum": 10000,
"minimum": 200,
"type": "integer"
},
"t4NormalTimer": {
"description": "Normal proving timer. The amount of time (in milliseconds) MTP2 sends Link Status Proving messages during normal proving. Typical value is 2300.",
"maximum": 70000,
"minimum": 500,
"type": "integer"
},
"t5Timer": {
"description": "Sending SIB timer. Typical value is 90.",
"maximum": 500,
"minimum": 40,
"type": "integer"
},
"t6Timer": {
"description": "Remote congestion timer. The amount of time (in milliseconds) that a congested link will remain in service. Typical value is 4000.",
"maximum": 10000,
"minimum": 1000,
"type": "integer"
},
"t7Timer": {
"description": "Excessive acknowledgement delay timer. The amount of time (in milliseconds) for which M2PA waits between transmission of a user data message and receipt of an acknowledgement for that message from the peer. If this timer expires, the link is taken out of service. Typical value is 300.",
"maximum": 3000,
"minimum": 200,
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
}
Example
{
"name": "mtp2Conf1",
"t1Timer": 9000,
"t2Timer": 9000,
"t3Timer": 9000,
"t4EmergencyTimer": 600,
"t4NormalTimer": 2300,
"t5Timer": 90,
"t6Timer": 4000,
"t7Timer": 300
}
delete /vstp/mtp2timersetconfigs/{name}
Deletes the specified Mtp2 Config from the SOAM configuration. A Mtp2 Config can only be deleted if all delete validation checks pass. In general, An attempt to delete a Mtp2 Config that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Mtp2Board
A Mtp2Board is used to store the Board Data Information. All these configurations go into VstpMtp2BoardMergeData table.
All configuration of Mtp2Board is done at the VSTP MP.
/vstp/mtp2board
get /vstp/mtp2board
Returns all board data which is merged from VSTP MP that meet the criteria specified in the GET request. By default, all records configured at the VSTP MP are returned. If paging parameters are supplied, only those records meeting the request parameters are returned.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/mtp2boardItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mtp2board/mtp2board.json",
"properties": {
"sourceNode": {
"description": "This is the name of originating node.",
"type": "string"
},
"boardType": {
"description": "This defines the types of board.",
"type": "string"
},
"mrl": {
"description": "This defines the MRL value of the board.",
"type": "string"
},
"serialNum": {
"description": "This defines the Serial Number of the board.",
"type": "string"
},
"pormVer": {
"description": "This defines the PORM Version of the board",
"type": "string"
},
"machVer": {
"description": "This defines the MACH Version of the board.",
"type": "string"
},
"elt1Port": {
"description": "This defines the number of E1/T1 ports.",
"type": "string"
},
"ethPort": {
"description": "This defines the number of Ethernet ports.",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"sourceNode": "Node1",
"boardType": "type1",
"mrl": "123",
"serialNum": "456",
"pormVer": "678",
"machVer": "345",
"elt1Port": "23456",
"ethPort": "234523"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
Vstp: Network Appearances
Network Appearance identifies the SS7 network content of the message.
All configuration of Network Appearance is done at the SOAM.
/vstp/networkappearances
get /vstp/networkappearances
Returns all Network Appearances that meet the criteria specified in the GET request. By default, all Network Appearances configured at the SOAM are returned. If paging parameters are supplied, only those Network Appearances meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/networkappearanceCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/networkappearance/networkappearance.json",
"properties": {
"na":{
"description": "Network appearance.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"naType":{
"description": "Network appearance type.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "Group code of network appearance.",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"type": "string"
},
"name": {
"description": "Name for this network appearance Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"na",
"naType"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
[
{
"name": "Na1",
"na": 1,
"naType": "Itui"
},
{
"name": "Na2",
"na": 10,
"naType": "Itun",
"groupCode": "ab"
}
]
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/networkappearances
Adds a new Network Appearance to the VSTP configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/networkappearance/networkappearance.json",
"properties": {
"na":{
"description": "Network appearance.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"naType":{
"description": "Network appearance type.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "Group code of network appearance.",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"type": "string"
},
"name": {
"description": "Name for this network appearance Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"na",
"naType"
],
"type": "object"
}
Example
[
{
"name": "Na1",
"na": 1,
"naType": "Itui"
},
{
"name": "Na2",
"na": 10,
"naType": "Itun",
"groupCode": "ab"
}
]
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/networkappearances/{name}
get /vstp/networkappearances/{name}
Returns the configuration details for the specified Network Appearance. If the Network APpearance does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/networkappearanceItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/networkappearance/networkappearance.json",
"properties": {
"na":{
"description": "Network appearance.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"naType":{
"description": "Network appearance type.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "Group code of network appearance.",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"type": "string"
},
"name": {
"description": "Name for this network appearance Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"na",
"naType"
],
"type": "object"
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
[
{
"name": "Na1",
"na": 1,
"naType": "Itui"
},
{
"name": "Na2",
"na": 10,
"naType": "Itun",
"groupCode": "ab"
}
]
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/networkappearances/{name}
Updates the configuration of the specified Network Appearance. If the provided Network Appearance data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/networkappearance/networkappearance.json",
"properties": {
"na":{
"description": "Network appearance.",
"maximum": 4294967295,
"minimum": 0,
"type": "integer"
},
"naType":{
"description": "Network appearance type.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "Group code of network appearance.",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"type": "string"
},
"name": {
"description": "Name for this network appearance Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"required": [
"name",
"na",
"naType"
],
"type": "object"
}
Example
[
{
"name": "Na1",
"na": 1,
"naType": "Itui"
},
{
"name": "Na2",
"na": 10,
"naType": "Itun",
"groupCode": "ab"
}
]
delete /vstp/networkappearances/{name}
Deletes the specified Network Appearance from the SOAM configuration. A Network Appearance can only be deleted if all delete validation checks pass. An attempt to delete a Network Appearance that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Remote Hosts
A Remote Host is the VSTP's logical representation of a remote node, accessible over one or more transport connections, with which the VSTP can transact Vstp messages. The Remote Host managed object encapsulates all the characteristics of the remote node that the VSTP must know about in order to communicate successfully with it.
All Remote Host configuration is done at the SOAM.
/vstp/remotehosts
get /vstp/remotehosts
Returns all Remote Hosts that meet the criteria specified in the GET request. By default, all Remote Hosts configured at the SOAM will be returned. If paging parameters are supplied, only those Remote Hosts meeting the request parameters will be returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/remotehostCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotehost/remotehost.json",
"properties": {
"remoteHostName": {
"description": "Name for the Remote Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostPort": {
"description": "Listen Port number of this Remote Host. This is mandatory attribute for remote host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"remoteHostPriIPAddress": {
"description": "Primary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for remote host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"remoteHostSecIPAddress": {
"description": "Secondary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"remoteHostName",
"remoteHostPort",
"remoteHostPriIPAddress"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "0",
"remoteHostName": "RemoteHost1",
"remoteHostPort": 2346,
"remoteHostPriIPAddress": "10.10.1.10",
"remoteHostSecIPAddress": "10.10.1.11",
"remoteHostType": "Remote"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/remotehosts
Adds a new Remote Host to the VSTP configuration. The new Remote Host must have a name that is unique across all Remote Hosts at the SOAM. In addition, the Remote Host's IP Port combination must also be unique across all Remote Hosts configured at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotehost/remotehost.json",
"properties": {
"remoteHostName": {
"description": "Name for the Remote Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostPort": {
"description": "Listen Port number of this Remote Host. This is mandatory attribute for remote host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"remoteHostPriIPAddress": {
"description": "Primary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for remote host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"remoteHostSecIPAddress": {
"description": "Secondary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"remoteHostName",
"remoteHostPort",
"remoteHostPriIPAddress"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"remoteHostName": "RemoteHost1",
"remoteHostPort": 2346,
"remoteHostPriIPAddress": "10.10.1.10",
"remoteHostSecIPAddress": "10.10.1.11",
"remoteHostType": "Remote"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/remotehosts/{name}
get /vstp/remotehosts/{name}
Returns the configuration details for the specified Remote Host. If the specified Remote Host does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/remotehostItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotehost/remotehost.json",
"properties": {
"remoteHostName": {
"description": "Name for the Remote Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostPort": {
"description": "Listen Port number of this Remote Host. This is mandatory attribute for remote host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"remoteHostPriIPAddress": {
"description": "Primary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for remote host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"remoteHostSecIPAddress": {
"description": "Secondary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"remoteHostName",
"remoteHostPort",
"remoteHostPriIPAddress"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"remoteHostName": "RemoteHost1",
"remoteHostPort": 2346,
"remoteHostPriIPAddress": "10.10.1.10",
"remoteHostSecIPAddress": "10.10.1.11",
"remoteHostType": "Remote"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/remotehosts/{name}
Updates the configuration for the specified Remote Host. If the provided Remote Host data is invalid in any way, the update will fail, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotehost/remotehost.json",
"properties": {
"remoteHostName": {
"description": "Name for the Remote Host, which must be unique within the VSTP site. A name is required, and cannot be changed after the Peer Node is initially configured. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteHostPort": {
"description": "Listen Port number of this Remote Host. This is mandatory attribute for remote host.",
"maximum": 65535,
"minimum": 1024,
"type": "integer"
},
"remoteHostPriIPAddress": {
"description": "Primary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is mandatory attribute for remote host.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"remoteHostSecIPAddress": {
"description": "Secondary IP address of this Remote Host. Each value provided must be a valid IPv4 or IPv6 address. This is optional.",
"maxLength": 39,
"pattern": "^((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))$|^([0-9A-Fa-f:]){1,46}$|^([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\\.]*[0-9A-Fa-f]){0,46}$",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
}
},
"required": [
"remoteHostName",
"remoteHostPort",
"remoteHostPriIPAddress"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"remoteHostName": "RemoteHost1",
"remoteHostPort": 2346,
"remoteHostPriIPAddress": "10.10.1.10",
"remoteHostSecIPAddress": "10.10.1.11",
"remoteHostType": "Remote"
}
delete /vstp/remotehosts/{name}
Deletes the specified Remote Host from the SOAM configuration. A Remote Host will only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Remote Signaling Points
A Remote Signaling Point represents an SS7 network node (point code) with which a VSTP Local Node (/vstp/localhosts) communicates. A Remote Signaling Point resource encapsulates the characteristics required to route the signaling to the Remote Host (/vstp/remotehosts).
All configuration of the Remote Signaling Points is done at the SOAM.
/vstp/remotesignalingpoints
get /vstp/remotesignalingpoints
Returns all Remote Signaling Points that meet the criteria specified in the GET request. By default, all Remote Signaling Points configured at the SOAM are returned. If paging parameters are supplied, only those Remote Signaling Points meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/remotesignalingpointCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotesignalingpoint/remotesignalingpoint.json",
"properties": {
"aliasPointCode1": {
"description": "Alias Point Code1.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode2": {
"description": "Alias Point Code2.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode1DomainType": {
"description": "This defines the type of Alias Point Code1 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode2DomainType": {
"description": "This defines the type of Alias Point Code2 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode1GroupCode": {
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
},
"enableBroadcastException": {
"description": "When set to true, the VSTP does not broadcast TFP/TFA to the adjacent node whenever the Linksets (/vstp/linksets) status is changed. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mtpPointCode": {
"description": "mtpPointCode is the unique address for this Remote Signaling Point, and is used in MTP layer 3 to identify the destination of a Message Signal Unit (MSU).",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "Name for this Remote Signaling Point, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. If name is not provided by user, the name will be automatically generated as ss7DomainType_mtpPointCode. E.g. Ansi_3_3_3 for ss7DomainType is Ansi and mtpPointCode 3-3-3.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nprst": {
"description": "NM bits reset. This parameter specifies whether the NM bits should be set to 00.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"rcause": {
"description": "Release cause. The condition that triggers the sending of a Release message. If the rlcopc parameter is specified and a value of 0-127 is specified for the rcause parameter, then the rcause parameter value overrides the values specified for the TIFOPTS rcausenp and rcausepfx parameters.",
"maxLength": 4,
"pattern": "^(12[0-7]|1[01][0-9]|[1-9]?[0-9])$|^(None)$",
"default": "None",
"type": "string"
},
"splitiam": {
"description": "This parameter specifies when and how to split an ITU IAM message into 1 IAM message + 1 SAM message. This parameter applies only to ITU IAM messages.",
"maxLength": 4,
"pattern": "^(1[5-9]|2[0-9]|3[01])$|^(None)$",
"default": "None",
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"ss7DomainType"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"enableBroadcastException": true,
"configurationLevel": "0",
"mtpPointCode": "1-1-1",
"name": "RSP1",
"ss7DomainType": "Ansi"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/remotesignalingpoints
Adds a new Remote Signaling Point to the VSTP configuration. The Remote Signaling Point name must be unique across all Remote Signaling Points at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotesignalingpoint/remotesignalingpoint.json",
"properties": {
"aliasPointCode1": {
"description": "Alias Point Code1.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode2": {
"description": "Alias Point Code2.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode1DomainType": {
"description": "This defines the type of Alias Point Code1 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode2DomainType": {
"description": "This defines the type of Alias Point Code2 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode1GroupCode": {
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
},
"enableBroadcastException": {
"description": "When set to true, the VSTP does not broadcast TFP/TFA to the adjacent node whenever the Linksets (/vstp/linksets) status is changed. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mtpPointCode": {
"description": "mtpPointCode is the unique address for this Remote Signaling Point, and is used in MTP layer 3 to identify the destination of a Message Signal Unit (MSU).",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "Name for this Remote Signaling Point, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. If name is not provided by user, the name will be automatically generated as ss7DomainType_mtpPointCode. E.g. Ansi_3_3_3 for ss7DomainType is Ansi and mtpPointCode 3-3-3.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nprst": {
"description": "NM bits reset. This parameter specifies whether the NM bits should be set to 00.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"rcause": {
"description": "Release cause. The condition that triggers the sending of a Release message. If the rlcopc parameter is specified and a value of 0-127 is specified for the rcause parameter, then the rcause parameter value overrides the values specified for the TIFOPTS rcausenp and rcausepfx parameters.",
"maxLength": 4,
"pattern": "^(12[0-7]|1[01][0-9]|[1-9]?[0-9])$|^(None)$",
"default": "None",
"type": "string"
},
"splitiam": {
"description": "This parameter specifies when and how to split an ITU IAM message into 1 IAM message + 1 SAM message. This parameter applies only to ITU IAM messages.",
"maxLength": 4,
"pattern": "^(1[5-9]|2[0-9]|3[01])$|^(None)$",
"default": "None",
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"ss7DomainType"
],
"type": "object"
}
Example
{
"enableBroadcastException": true,
"configurationLevel": "0",
"mtpPointCode": "1-1-1",
"name": "RSP1",
"ss7DomainType": "Ansi"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/remotesignalingpoints/status
get /vstp/remotesignalingpoints/status
Returns the status of all Remote Signaling Points that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data (except statusKnown - this attribute cannot be filtered). Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, or IN. LIKE is not supported for these data types. Boolean attributes can be filtered using only EQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=name
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=Rsp1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/remotesignalingpointstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotesignalingpoint/remotesignalingpointstatus.json",
"properties": {
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the VSTP-MP server that is currently reporting the status of this Remote Signaling Point.",
"type": "string"
},
"name": {
"description": "The configured name of the Remote Signaling Point.",
"type": "string"
},
"operationalStatus": {
"description": "The operational status for this Remote Signaling Point. When set to Available, it shows the Routes configured corresponding to this Remote Signaling Point are Available. When set to Unavailable, it shows the Routes configured corresponding to this Remote Signaling Point are Unavailable. When set to Congested, it shows the destination to the configured Routes corresponding to this Remote Signaling Point is congested even though the Routes are Available. When set to NonPreferred, it shows that one of the Routes configured corresponding to this Remote Signaling Point is not preferred over the other Route configured. When set to ApplDown, application is not running on this Remote Signaling Point. Default operationalStatus of a Remote Signaling Point is Available.",
"enum": [
"Available",
"Unavailable",
"Congested",
"Restricted",
"ApplDown"
],
"type": "string"
},
"pointCode": {
"description": "The unique address for this Remote Signaling Point.",
"type": "string"
},
"routes": {
"description": "A Remote Signaling Point can have up to two Routes (/vstp/routes) configured, and any Route listed here must be configured in an associated Route Table.",
"items": {
"properties": {
"routeAdjacentStatus": {
"description": "The status of the adjacent part. When set to Down, the adjacent part to this Remote Signaling Point is down. When set to Up, the adjacent part to this Remote Signaling Point is up. When set to Unassigned, the adjacent part to this Remote Signaling Point is not assigned to any other Remote Signaling Point.",
"enum": [
"Down",
"Restricted",
"Up",
"Unassigned"
],
"type": "string"
},
"routeName": {
"description": "The name of this Route (/vstp/routes).",
"type": "string"
},
"routeRemoteStatus": {
"description": "The status of the non adjacent part. When set to Available, the non adjacent part to this Remote Signaling Point is Available. When set to Unavailable, the non adjacent part to this Remote Signaling Point is not available. When set to Restricted, the non adjacent part to this Remote Signaling Point is Restricted. When set to Unassigned, the non adjacent part to this Remote Signaling Point is not assigned to other Remote Signaling Point. The default status is Available.",
"enum": [
"Available",
"Unavailable",
"Restricted",
"Unassigned"
],
"type": "string"
},
"routeStatus": {
"description": "The status of Route. When set to Available, the route to this Remote Signaling Point is Available. When set to Unavailable, the route to this Remote Signaling Point is not available. When set to Restricted, the route to this Remote Signaling Point isRestricted. When set to Unassigned, the route to this Remote Signaling Point is not assigned to other Remote Signaling Point.",
"enum": [
"Available",
"Unavailable",
"Restricted",
"Unassigned"
],
"type": "string"
},
"routeCost": {
"description": "The relative cost assigned to this route. Lower cost routes are preferred over higher cost routes.",
"maximum": 99,
"minimum": 0,
"type": "integer"
},
"adjacentPC": {
"description": "Name of the Adjacent Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"linksetName": {
"description": "This defines the name of the Linkset (/vstp/linksets) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"type": "object"
},
"maxItems": 6,
"minItems": 0,
"type": "array"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this RSP are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this RSP. If the OAM has current status for this RSP, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time status for the destination last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"mpServerHostname": "amisha-so1mp1",
"name": "TestRemoteSp1",
"operationalStatus": "Available",
"pointCode": "004-004-004",
"routes": [
{
"routeAdjacentStatus": "Available",
"routeName": "RouteTest11",
"routeRemoteStatus": "Available"
},
{
"routeAdjacentStatus": "Down",
"routeName": "RouteTest12",
"routeRemoteStatus": "Available"
}
],
"ss7DomainType":"Ansi",
"statusKnown": true,
"timeOfLastUpdate": "1969-12-31T19:00:00-05:00"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/vstp/remotesignalingpoints/{name}
get /vstp/remotesignalingpoints/{name}
Returns the configuration details for the specified Remote Signaling Point. If the Remote Signaling Point does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/remotesignalingpointItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotesignalingpoint/remotesignalingpoint.json",
"properties": {
"aliasPointCode1": {
"description": "Alias Point Code1.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode2": {
"description": "Alias Point Code2.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode1DomainType": {
"description": "This defines the type of Alias Point Code1 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode2DomainType": {
"description": "This defines the type of Alias Point Code2 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode1GroupCode": {
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
},
"enableBroadcastException": {
"description": "When set to true, the VSTP does not broadcast TFP/TFA to the adjacent node whenever the Linksets (/vstp/linksets) status is changed. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mtpPointCode": {
"description": "mtpPointCode is the unique address for this Remote Signaling Point, and is used in MTP layer 3 to identify the destination of a Message Signal Unit (MSU).",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "Name for this Remote Signaling Point, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. If name is not provided by user, the name will be automatically generated as ss7DomainType_mtpPointCode. E.g. Ansi_3_3_3 for ss7DomainType is Ansi and mtpPointCode 3-3-3.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nprst": {
"description": "NM bits reset. This parameter specifies whether the NM bits should be set to 00.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"rcause": {
"description": "Release cause. The condition that triggers the sending of a Release message. If the rlcopc parameter is specified and a value of 0-127 is specified for the rcause parameter, then the rcause parameter value overrides the values specified for the TIFOPTS rcausenp and rcausepfx parameters.",
"maxLength": 4,
"pattern": "^(12[0-7]|1[01][0-9]|[1-9]?[0-9])$|^(None)$",
"default": "None",
"type": "string"
},
"splitiam": {
"description": "This parameter specifies when and how to split an ITU IAM message into 1 IAM message + 1 SAM message. This parameter applies only to ITU IAM messages.",
"maxLength": 4,
"pattern": "^(1[5-9]|2[0-9]|3[01])$|^(None)$",
"default": "None",
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"ss7DomainType"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"enableBroadcastException": true,
"configurationLevel": "0",
"mtpPointCode": "1-1-1",
"name": "RSP1",
"ss7DomainType": "Ansi"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/remotesignalingpoints/{name}
Updates the configuration of the specified Remote Signaling Point. If the provided Remote Signaling Point data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotesignalingpoint/remotesignalingpoint.json",
"properties": {
"aliasPointCode1": {
"description": "Alias Point Code1.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode2": {
"description": "Alias Point Code2.",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"aliasPointCode1DomainType": {
"description": "This defines the type of Alias Point Code1 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode2DomainType": {
"description": "This defines the type of Alias Point Code2 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"aliasPointCode1GroupCode": {
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
},
"enableBroadcastException": {
"description": "When set to true, the VSTP does not broadcast TFP/TFA to the adjacent node whenever the Linksets (/vstp/linksets) status is changed. Typical value is false.",
"type": "boolean"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"mtpPointCode": {
"description": "mtpPointCode is the unique address for this Remote Signaling Point, and is used in MTP layer 3 to identify the destination of a Message Signal Unit (MSU).",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
},
"name": {
"description": "Name for this Remote Signaling Point, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit. If name is not provided by user, the name will be automatically generated as ss7DomainType_mtpPointCode. E.g. Ansi_3_3_3 for ss7DomainType is Ansi and mtpPointCode 3-3-3.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"nprst": {
"description": "NM bits reset. This parameter specifies whether the NM bits should be set to 00.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"rcause": {
"description": "Release cause. The condition that triggers the sending of a Release message. If the rlcopc parameter is specified and a value of 0-127 is specified for the rcause parameter, then the rcause parameter value overrides the values specified for the TIFOPTS rcausenp and rcausepfx parameters.",
"maxLength": 4,
"pattern": "^(12[0-7]|1[01][0-9]|[1-9]?[0-9])$|^(None)$",
"default": "None",
"type": "string"
},
"splitiam": {
"description": "This parameter specifies when and how to split an ITU IAM message into 1 IAM message + 1 SAM message. This parameter applies only to ITU IAM messages.",
"maxLength": 4,
"pattern": "^(1[5-9]|2[0-9]|3[01])$|^(None)$",
"default": "None",
"type": "string"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
}
},
"required": [
"mtpPointCode",
"ss7DomainType"
],
"type": "object"
}
Example
{
"enableBroadcastException": true,
"configurationLevel": "0",
"mtpPointCode": "1-1-1",
"name": "RSP1",
"ss7DomainType": "Ansi"
}
delete /vstp/remotesignalingpoints/{name}
Deletes the specified Remote Signaling Point from the SOAM configuration. A Remote Signaling Point can only be deleted if all delete validation checks pass. In general, if the Remote Signaling Point is a part of the configuration of Linksets (/vstp/linksets) or Routes (/vstp/routes), the Remote Signaling Point cannot be deleted. If the Remote Signaling Point is named in a Linkset or Route, the Remote Signaling Point must first be removed from the Linksets and Route. Then the Remote Signaling Point can be deleted from the configuration. An attempt to delete a Remote Signaling Point that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/vstp/remotesignalingpoints/{name}/status
get /vstp/remotesignalingpoints/{name}/status
Retrieves the operational status for the specified Remote Signaling Point.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/remotesignalingpointstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/remotesignalingpoint/remotesignalingpointstatus.json",
"properties": {
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the VSTP-MP server that is currently reporting the status of this Remote Signaling Point.",
"type": "string"
},
"name": {
"description": "The configured name of the Remote Signaling Point.",
"type": "string"
},
"operationalStatus": {
"description": "The operational status for this Remote Signaling Point. When set to Available, it shows the Routes configured corresponding to this Remote Signaling Point are Available. When set to Unavailable, it shows the Routes configured corresponding to this Remote Signaling Point are Unavailable. When set to Congested, it shows the destination to the configured Routes corresponding to this Remote Signaling Point is congested even though the Routes are Available. When set to NonPreferred, it shows that one of the Routes configured corresponding to this Remote Signaling Point is not preferred over the other Route configured. When set to ApplDown, application is not running on this Remote Signaling Point. Default operationalStatus of a Remote Signaling Point is Available.",
"enum": [
"Available",
"Unavailable",
"Congested",
"Restricted",
"ApplDown"
],
"type": "string"
},
"pointCode": {
"description": "The unique address for this Remote Signaling Point.",
"type": "string"
},
"routes": {
"description": "A Remote Signaling Point can have up to two Routes (/vstp/routes) configured, and any Route listed here must be configured in an associated Route Table.",
"items": {
"properties": {
"routeAdjacentStatus": {
"description": "The status of the adjacent part. When set to Down, the adjacent part to this Remote Signaling Point is down. When set to Up, the adjacent part to this Remote Signaling Point is up. When set to Unassigned, the adjacent part to this Remote Signaling Point is not assigned to any other Remote Signaling Point.",
"enum": [
"Down",
"Restricted",
"Up",
"Unassigned"
],
"type": "string"
},
"routeName": {
"description": "The name of this Route (/vstp/routes).",
"type": "string"
},
"routeRemoteStatus": {
"description": "The status of the non adjacent part. When set to Available, the non adjacent part to this Remote Signaling Point is Available. When set to Unavailable, the non adjacent part to this Remote Signaling Point is not available. When set to Restricted, the non adjacent part to this Remote Signaling Point is Restricted. When set to Unassigned, the non adjacent part to this Remote Signaling Point is not assigned to other Remote Signaling Point. The default status is Available.",
"enum": [
"Available",
"Unavailable",
"Restricted",
"Unassigned"
],
"type": "string"
},
"routeStatus": {
"description": "The status of Route. When set to Available, the route to this Remote Signaling Point is Available. When set to Unavailable, the route to this Remote Signaling Point is not available. When set to Restricted, the route to this Remote Signaling Point isRestricted. When set to Unassigned, the route to this Remote Signaling Point is not assigned to other Remote Signaling Point.",
"enum": [
"Available",
"Unavailable",
"Restricted",
"Unassigned"
],
"type": "string"
},
"routeCost": {
"description": "The relative cost assigned to this route. Lower cost routes are preferred over higher cost routes.",
"maximum": 99,
"minimum": 0,
"type": "integer"
},
"adjacentPC": {
"description": "Name of the Adjacent Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Link Set.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"linksetName": {
"description": "This defines the name of the Linkset (/vstp/linksets) associated with this Link.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
}
},
"type": "object"
},
"maxItems": 6,
"minItems": 0,
"type": "array"
},
"ss7DomainType": {
"description": "This defines the type of SS7 domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"groupCode":{
"description": "This defines ITUN group code for duplicate point code feature",
"maxLength": 2,
"pattern": "^([a-z]{2})$",
"default" : "aa",
"type": "string"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this RSP are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this RSP. If the OAM has current status for this RSP, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time status for the destination last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"mpServerHostname": "amisha-so1mp1",
"name": "TestRemoteSp1",
"operationalStatus": "Available",
"pointCode": "004-004-004",
"routes": [
{
"routeAdjacentStatus": "Available",
"routeName": "RouteTest11",
"routeRemoteStatus": "Available"
},
{
"routeAdjacentStatus": "Down",
"routeName": "RouteTest12",
"routeRemoteStatus": "Available"
}
],
"ss7DomainType":"Ansi",
"statusKnown": true,
"timeOfLastUpdate": "1969-12-31T19:00:00-05:00"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
Vstp: Routes
A Route is a user-configured resource that represents a signaling path from a Local Signaling Point (/vstp/localsignalingpoints) point code to a Remote Signaling Point (RSP) (/vstp/remotesignalingpoints) point code using a given Link Set (/vstp/linksets). Routes are needed for adjacent RSP to route network management signaling. A Route consists of an RSP, a Link Set, and a relative cost.
All configuration of the Routes is done at the SOAM.
/vstp/routes
get /vstp/routes
Returns all Routes that meet the criteria specified in the GET request. By default, all Routes configured at the SOAM are returned. If paging parameters are supplied, only those Routes meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/routeCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/route/routes.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"linksetName": {
"description": "Name of the Link Set (/vstp/linksets) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this Route, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeCost": {
"description": "The relative cost assigned to this route. Lower cost routes are preferred over higher cost routes.",
"maximum": 99,
"minimum": 0,
"type": "integer"
}
},
"required": [
"linksetName",
"name",
"remoteSignalingPointName",
"routeCost"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "1",
"linksetName": "ls1",
"name": "route1",
"remoteSignalingPointName": "rsp1",
"routeCost": 56
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/routes
Adds a new Route to the VSTP configuration. The Route name must be unique across all Routes at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/route/routes.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"linksetName": {
"description": "Name of the Link Set (/vstp/linksets) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this Route, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeCost": {
"description": "The relative cost assigned to this route. Lower cost routes are preferred over higher cost routes.",
"maximum": 99,
"minimum": 0,
"type": "integer"
}
},
"required": [
"linksetName",
"name",
"remoteSignalingPointName",
"routeCost"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"linksetName": "ls1",
"name": "route1",
"remoteSignalingPointName": "rsp1",
"routeCost": 56
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/routes/{name}
get /vstp/routes/{name}
Returns the configuration details for the specified Route. If the Route does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/routeItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/route/routes.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"linksetName": {
"description": "Name of the Link Set (/vstp/linksets) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this Route, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeCost": {
"description": "The relative cost assigned to this route. Lower cost routes are preferred over higher cost routes.",
"maximum": 99,
"minimum": 0,
"type": "integer"
}
},
"required": [
"linksetName",
"name",
"remoteSignalingPointName",
"routeCost"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "1",
"linksetName": "ls1",
"name": "route1",
"remoteSignalingPointName": "rsp1",
"routeCost": 56
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/routes/{name}
Updates the configuration of the specified Route. If the provided Route data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/route/routes.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"linksetName": {
"description": "Name of the Link Set (/vstp/linksets) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"name": {
"description": "Name for this Route, which must be unique within the VSTP site. Valid names are strings between one and 32 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"remoteSignalingPointName": {
"description": "Name of the Remote Signaling Point (/vstp/remotesignalingpoints) associated with this Route.",
"maxLength": 32,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"routeCost": {
"description": "The relative cost assigned to this route. Lower cost routes are preferred over higher cost routes.",
"maximum": 99,
"minimum": 0,
"type": "integer"
}
},
"required": [
"linksetName",
"name",
"remoteSignalingPointName",
"routeCost"
],
"type": "object"
}
Example
{
"configurationLevel": "1",
"linksetName": "ls1",
"name": "route1",
"remoteSignalingPointName": "rsp1",
"routeCost": 56
}
delete /vstp/routes/{name}
Deletes the specified Route from the SOAM configuration. An attempt to delete a Route which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Sccp Applications
An Sccp Application is used to trigger an specific application of vstp.An Applications cannot be edited. An Application can be changed only by deleting it.
/vstp/sccpapplications
get /vstp/sccpapplications
Returns all Sccp Applications that meet the criteria specified in the GET request. By default, all applications configured at the SOAM are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/sccpapplicationCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id":"http://dsr.cgbu.oracle.com/schemas/vstp/sccpapplication/sccpapplication.json",
"properties":{
"appType":{
"description":"Type of Application.",
"enum":[
"Eir",
"Atinp",
"Inpq",
"Sfapp",
"SmsProxy"
],
"default":"Eir",
"type":"string"
},
"ssn":{
"description":"Sub System Number. ",
"maximum":255,
"minimum":2,
"type":"integer"
}
},
"required":[
"appType",
"ssn"
],
"type":"object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"appType": "Eir",
"ssn": 67
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/sccpapplications
Adds a new Sccp Application to the VSTP configuration. The Application Type must be unique across all Application at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id":"http://dsr.cgbu.oracle.com/schemas/vstp/sccpapplication/sccpapplication.json",
"properties":{
"appType":{
"description":"Type of Application.",
"enum":[
"Eir",
"Atinp",
"Inpq",
"Sfapp",
"SmsProxy"
],
"default":"Eir",
"type":"string"
},
"ssn":{
"description":"Sub System Number. ",
"maximum":255,
"minimum":2,
"type":"integer"
}
},
"required":[
"appType",
"ssn"
],
"type":"object"
}
Example
{
"appType": "Eir",
"ssn": 67
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/sccpapplications/status
get /vstp/sccpapplications/status
Returns the status of all Links that meet the criteria specified in the request. This API supports filtering on any single attribute returned in the JSON data (except operationalReason, statusKnown - these attributes cannot be filtered). Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE, or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, or IN. LIKE is not supported for these data types. Boolean attributes can be filtered using only EQUAL.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=appId
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/sccpapplicationstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/link/sccpapplicationstatus.json",
"properties": {
"appAdminState": {
"description": "Displays the administrative state of this Application",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"appId": {
"description": "The unique id of the application.",
"type": "integer"
},
"appType":{
"description":"Type Of Application ",
"enum":[
"Eir",
"Atinp",
"Inpq",
"Sfapp"
],
"default":"None",
"type":"string"
},
"appOperState": {
"description":"The current operational state of the Application. While this attribute can have a value of Down or Up, operationalReason attribute typically contains additional information elaborating on the reported operationalStatus.",
"enum": [
"Available",
"Unavailable",
"Degraded"
],
"type": "string"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the VSTP-MP server that is currently reporting the status of this Application.",
"type": "string"
},
"ssn":{
"description":"Sub System Number",
"maximum":255,
"minimum":2,
"type":"integer"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Link are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this Application, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Link was last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"appAdminState": "Disabled",
"appId": 1,
"appType": "Eir",
"appOperState": "Available",
"mpServerHostname": "VSTPMP1",
"ssn": 0,
"statusKnown": true,
"timeOfLastUpdate": "1969-12-31T19:00:00-05:00"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
/vstp/sccpapplications/{name}
get /vstp/sccpapplications/{name}
Returns the configuration details for the specified Application. If the Application does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sccpapplicationItem.json",
"type": "object",
"properties": {
"data":
{
"id":"http://dsr.cgbu.oracle.com/schemas/vstp/sccpapplication/sccpapplication.json",
"properties":{
"appType":{
"description":"Type of Application.",
"enum":[
"Eir",
"Atinp",
"Inpq",
"Sfapp",
"SmsProxy"
],
"default":"Eir",
"type":"string"
},
"ssn":{
"description":"Sub System Number. ",
"maximum":255,
"minimum":2,
"type":"integer"
}
},
"required":[
"appType",
"ssn"
],
"type":"object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"appType": "Eir",
"ssn": 67
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/sccpapplications/{name}
delete /vstp/sccpapplications/{name}
Deletes the specified Sccp Applicationfrom the SOAM configuration. A Application can only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
/vstp/sccpapplications/{name}/status
get /vstp/sccpapplications/{name}/status
Retrieves the operational status for the specified Application.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sccpapplicationstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/link/sccpapplicationstatus.json",
"properties": {
"appAdminState": {
"description": "Displays the administrative state of this Application",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
},
"appId": {
"description": "The unique id of the application.",
"type": "integer"
},
"appType":{
"description":"Type Of Application ",
"enum":[
"Eir",
"Atinp",
"Inpq",
"Sfapp"
],
"default":"None",
"type":"string"
},
"appOperState": {
"description":"The current operational state of the Application. While this attribute can have a value of Down or Up, operationalReason attribute typically contains additional information elaborating on the reported operationalStatus.",
"enum": [
"Available",
"Unavailable",
"Degraded"
],
"type": "string"
},
"mpServerHostname": {
"description": "mpServerHostname indicates the name of the VSTP-MP server that is currently reporting the status of this Application.",
"type": "string"
},
"ssn":{
"description":"Sub System Number",
"maximum":255,
"minimum":2,
"type":"integer"
},
"statusKnown": {
"description": "When set to false, current values for the run-time status attributes for this Link are not known by the OAM. This could be due to merge issues within the VSTP, or some other cause preventing the OAM from having a current view of the status of this Connection. If the OAM has current status for this Application, statusKnown is set to true.",
"type": "boolean"
},
"timeOfLastUpdate": {
"description": "The date/time the status for this Link was last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"appAdminState": "Disabled",
"appId": 1,
"appType": "Eir",
"appOperState": "Available",
"mpServerHostname": "VSTPMP1",
"ssn": 0,
"statusKnown": true,
"timeOfLastUpdate": "1969-12-31T19:00:00-05:00"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
/vstp/sccpapplications/{name}/sccpapplicationadminstate
get /vstp/sccpapplications/{name}/sccpapplicationadminstate
Retrieves the administrative state, which can be either Enabled or Disabled, for the specified Application.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sccpapplicationadminstateItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schema/vstp/sccpapplication/sccpapplicationadminstate.json",
"properties": {
"adminState": {
"description": "An Application's administrative state can be either Enabled or Disabled. An Application's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
}
},
"required": ["adminState"],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"adminState": "Enabled"
}
~
~
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/sccpapplications/{name}/sccpapplicationadminstate
Updates the administrative state for the specified VSTP Sccp Application to either Enabled or Disabled.
A Sccp Application's configuration cannot be modified or deleted if its administrative state is Enabled.
Target server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schema/vstp/sccpapplication/sccpapplicationadminstate.json",
"properties": {
"adminState": {
"description": "An Application's administrative state can be either Enabled or Disabled. An Application's configuration cannot be modified or deleted if its administrative state is Enabled.",
"enum": [
"Enabled",
"Disabled"
],
"type": "string"
}
},
"required": ["adminState"],
"type": "object"
}
Example
{
"adminState": "Enabled"
}
~
~
Vstp: Sccp Loopsets
Defines all the data related to SccpLoopSet entry.
All configuration of Sccp loop is done at the SOAM.
/vstp/sccploopsets
get /vstp/sccploopsets
Returns all Sccp Loopsets that meet the criteria specified in the GET request. By default, all Loop configured at the SOAM are returned. If paging parameters are supplied, only those Sccp loops meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/sccploopsetCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccploopset/sccploopsets.json",
"properties": {
"action": {
"description": "Defines the action to be taken when Sccp Loop is detected",
"enum": [
"notifyOnly",
"discardOnly"
],
"default": "notifyOnly",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s",
"Itun16"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp loopset, which must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pointCodeList": {
"description": "List of signaling Pointcodes",
"items": {
"type": "string"
},
"maxItems": 12,
"minItems": 1,
"type": "array",
"uniqueItems": true
}
},
"required": [
"name",
"domain"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"action": "notifyOnly",
"configurationLevel": "0",
"domain":"Itui",
"name":"loopset1",
"pointCodeList": [
"3-3-3",
"5-5-5",
"7-7-7",
"3-4-3"
]
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/sccploopsets
Adds a new Loop to the VSTP configuration. The Sccp Loop name must be unique.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccploopset/sccploopsets.json",
"properties": {
"action": {
"description": "Defines the action to be taken when Sccp Loop is detected",
"enum": [
"notifyOnly",
"discardOnly"
],
"default": "notifyOnly",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s",
"Itun16"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp loopset, which must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pointCodeList": {
"description": "List of signaling Pointcodes",
"items": {
"type": "string"
},
"maxItems": 12,
"minItems": 1,
"type": "array",
"uniqueItems": true
}
},
"required": [
"name",
"domain"
],
"type": "object"
}
Example
{
"action": "notifyOnly",
"configurationLevel": "0",
"domain":"Itui",
"name":"loopset1",
"pointCodeList": [
"3-3-3",
"5-5-5",
"7-7-7",
"3-4-3"
]
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/sccploopsets/{name}
get /vstp/sccploopsets/{name}
Returns the configuration details for the specified Sccp Loop. If the loop does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sccploopsetItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccploopset/sccploopsets.json",
"properties": {
"action": {
"description": "Defines the action to be taken when Sccp Loop is detected",
"enum": [
"notifyOnly",
"discardOnly"
],
"default": "notifyOnly",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s",
"Itun16"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp loopset, which must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pointCodeList": {
"description": "List of signaling Pointcodes",
"items": {
"type": "string"
},
"maxItems": 12,
"minItems": 1,
"type": "array",
"uniqueItems": true
}
},
"required": [
"name",
"domain"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"action": "notifyOnly",
"configurationLevel": "0",
"domain":"Itui",
"name":"loopset1",
"pointCodeList": [
"3-3-3",
"5-5-5",
"7-7-7",
"3-4-3"
]
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/sccploopsets/{name}
Updates the configuration of the specified Sccp LoopName. If the provided Modification data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccploopset/sccploopsets.json",
"properties": {
"action": {
"description": "Defines the action to be taken when Sccp Loop is detected",
"enum": [
"notifyOnly",
"discardOnly"
],
"default": "notifyOnly",
"type": "string"
},
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s",
"Itun16"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp loopset, which must be unique within the VSTP site. Valid names are strings between one and 9 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"pointCodeList": {
"description": "List of signaling Pointcodes",
"items": {
"type": "string"
},
"maxItems": 12,
"minItems": 1,
"type": "array",
"uniqueItems": true
}
},
"required": [
"name",
"domain"
],
"type": "object"
}
Example
{
"action": "notifyOnly",
"configurationLevel": "0",
"domain":"Itui",
"name":"loopset1",
"pointCodeList": [
"3-3-3",
"5-5-5",
"7-7-7",
"3-4-3"
]
}
delete /vstp/sccploopsets/{name}
Deletes the specified Sccp Loop from the SOAM configuration. A Sccp Loop can only be deleted if all delete validation checks pass.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: SCCP Options
The Signaling Connection Control Part (SCCP) Options are those configuration values that govern the overall SCCP functionality . There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new SCCP Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All SCCP Options configuration is done at the SOAM.
/vstp/sccpoptions
get /vstp/sccpoptions
Returns the set of current values for the SCCP Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sccpoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpoption/sccpoption.json",
"properties": {
"alwMsgDuringRsmblyErr": {
"description": "It specifies whether message will be allowed or discarded during reassembly failure. If alwMsgDuringRsmblyErr is True then message will be forwarded to upper layer for further processing. If alwMsgDuringRsmblyErr is false then message will be discarded and an XUDTS will be generated (provided return on error is set in the XUDT message).",
"default" : false,
"type": "boolean"
},
"class1seq": {
"description": "Enables or disables Class 1 message sequencing. When set to Enabled, Class 1 messages are guaranteed to be sequenced, but the messages are not load shared. When set to Disabled, Class 1 message sequencing is not guaranteed, but the messages might be load shared (if appropriate configuration exists).",
"enum" : [
"Enabled",
"Disabled"
],
"type": "string"
},
"dfltfallback": {
"description": "Default fallback option. This parameter specifies the action that is taken if the last translation doesn't match when performing GTT using a FLOBR-specific GTT mode. When set to false, GTT fails and the MSU is discarded. When set to true, GTT is performed based on the last matched entry.",
"default": false,
"type": "boolean"
},
"dfltgttmode": {
"description": "Default GTT mode. The system default value of the GTT mode hierarchy used by the DSR when performing GTT.",
"enum" : [
"Cd",
"Fcd",
"Fcg",
"Fcgfcd",
"Fcdfcg"
],
"default" : "Cd",
"type": "string"
},
"isSegXUDTfeatureEnable": {
"description": "It specifies whether the XUDT Segmentation feature is enabled. If isSegXUDTfeatureEnable is true then the feature is enabled.",
"default" : false,
"type": "boolean"
},
"mtprgtt": {
"description": "System-wide option for MTP Routed GTT, used to define GTT behavior on MTP Routed MSUs.",
"enum" : [
"Off",
"Usemtppc",
"Fullgtt"
],
"default" : "Off",
"type": "string"
},
"mtprgttfallback": {
"description": "System-wide option for MTP Routed GTT fallback, used to define error handling in case of failure for MTP routed MSUs.",
"enum" : [
"Mtproute",
"Gttfail"
],
"default" : "Mtproute",
"type": "string"
},
"reassemblyTimerDurationAnsi": {
"description": "Reassembly timer duration for ANSI domain. Time period after recieving the first segment, while waiting to recieve all the remaining segments related to same ANSI XUDT segmented message.",
"maximum": 20000,
"minimum": 5000,
"default": 5000,
"type": "integer"
},
"reassemblyTimerDurationItu": {
"description": "Reassembly timer duration for ITU domain. Time period after recieving the first segment, while waiting to recieve all the remaining segments related to same ITU XUDT segmented message.",
"maximum": 20000,
"minimum": 10000,
"default": 10000,
"type": "integer"
},
"segmentedMSULength": {
"description": "Length of Segmented MSU.",
"maximum": 272,
"minimum": 200,
"default": 200,
"type": "integer"
},
"smsDelivery": {
"description": "SMS Proxy Delivery Functionality Status.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"smsOrigination": {
"description": "SMS Proxy Origin Functionality Status.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"smsTermination": {
"description": "SMS Proxy Terminate Functionality Status.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"tcapErrorDiscard": {
"description": "TCAP Error Discard. If it is turned Off, MSU will be processed. While if it is turned on, MSU will be discarded.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"tgtt0": {
"description": "When set to Udt, transaction-based GTT loadsharing is enabled for UDTS and Class0 UDT messages. When set to Xudt, transaction-based GTT loadsharing is enabled for XUDTS and Class0 XUDT messages. When set to Both, transaction-based GTT loadsharing is enabled for UDTS, XUDTS, Class0 UDT and Class0 XUDT messages. When set to None, transaction-based GTT loadsharing is disabled for UDTS, XUDTS, Class0 UDT and Class0 XUDT messages. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Both",
"None",
"Udt",
"Xudt"
],
"type": "string"
},
"tgtt1": {
"description": "When set to Udt, transaction-based GTT loadsharing is enabled for UDTS and Class1 UDT messages. When set to Xudt, transaction-based GTT loadsharing is enabled for XUDTS and Class1 XUDT messages. When set to Both, transaction-based GTT loadsharing is enabled for UDTS, XUDTS, Class1 UDT and XUDT messages. When set to None, transaction-based GTT loadsharing is disabled for UDTS, XUDTS, Class1 UDT and Class1 XUDT messages. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Both",
"None",
"Udt",
"Xudt"
],
"type": "string"
},
"tgttudtkey": {
"description": "Defines the transaction parameter for incoming UDT(S) messages. Messages with this parameter are routed to the same load-shared remote Point Code within a MAPGROUP or MRNGROUP. When set to Mtp, transaction-based GTT loadsharing is performed using the MTP algorithm. When set to Tcap, transaction-based GTT loadsharing is performed using the TCAP algorithm. When set to Sccp, transaction-based GTT loadsharing is performed using the SCCP algorithm. When set to Enhmtp, transaction-based GTT loadsharing is performed using the ENHMTP algorithm. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Enhmtp",
"Mtp",
"Sccp",
"Tcap"
],
"type": "string"
},
"tgttxudtkey": {
"description": "Defines the transaction parameter for incoming XUDT(S) messages. Messages with this parameter are routed to the same load-shared remote Point Code within a MAPGROUP or MRNGROUP. When set to Mtp, transaction-based GTT loadsharing is performed using the MTP algorithm. When set to Sccp, transaction-based GTT loadsharing is performed using the SCCP algorithm. When set to Enhmtp, transaction-based GTT loadsharing is performed using the ENHMTP algorithm. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Enhmtp",
"Mtp",
"Sccp"
],
"type": "string"
},
"travelVelocity": {
"description": "Defines the velocity of travelling.",
"maximum": 700,
"minimum": 1,
"type": "integer"
},
"allowedFirstSegLen": {
"description": "It specifies the allowed length of the first XUDT segment.",
"maximum": 272,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"alwMsgDuringRsmblyErr": false,
"class1seq":"Disabled",
"dfltfallback": false,
"dfltgttmode": "Fcd",
"itun16ScmgEnabled": false,
"isSegXUDTfeatureEnable": false,
"mtprgtt": "Usemtppc",
"mtprgttfallback": "Gttfail",
"reassemblyTimerDurationAnsi": 5000,
"reassemblyTimerDurationItu": 10000,
"segmentedMSULength": 200,
"smsDelivery": "Off",
"smsOrigination": "Off",
"smsTermination": "Off",
"tcapErrorDiscard": "Off",
"tgtt0": "None",
"tgtt1": "None",
"tgttudtkey": "Mtp",
"tgttxudtkey": "Mtp"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/sccpoptions
Update the SCCP Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpoption/sccpoption.json",
"properties": {
"alwMsgDuringRsmblyErr": {
"description": "It specifies whether message will be allowed or discarded during reassembly failure. If alwMsgDuringRsmblyErr is True then message will be forwarded to upper layer for further processing. If alwMsgDuringRsmblyErr is false then message will be discarded and an XUDTS will be generated (provided return on error is set in the XUDT message).",
"default" : false,
"type": "boolean"
},
"class1seq": {
"description": "Enables or disables Class 1 message sequencing. When set to Enabled, Class 1 messages are guaranteed to be sequenced, but the messages are not load shared. When set to Disabled, Class 1 message sequencing is not guaranteed, but the messages might be load shared (if appropriate configuration exists).",
"enum" : [
"Enabled",
"Disabled"
],
"type": "string"
},
"dfltfallback": {
"description": "Default fallback option. This parameter specifies the action that is taken if the last translation doesn't match when performing GTT using a FLOBR-specific GTT mode. When set to false, GTT fails and the MSU is discarded. When set to true, GTT is performed based on the last matched entry.",
"default": false,
"type": "boolean"
},
"dfltgttmode": {
"description": "Default GTT mode. The system default value of the GTT mode hierarchy used by the DSR when performing GTT.",
"enum" : [
"Cd",
"Fcd",
"Fcg",
"Fcgfcd",
"Fcdfcg"
],
"default" : "Cd",
"type": "string"
},
"isSegXUDTfeatureEnable": {
"description": "It specifies whether the XUDT Segmentation feature is enabled. If isSegXUDTfeatureEnable is true then the feature is enabled.",
"default" : false,
"type": "boolean"
},
"mtprgtt": {
"description": "System-wide option for MTP Routed GTT, used to define GTT behavior on MTP Routed MSUs.",
"enum" : [
"Off",
"Usemtppc",
"Fullgtt"
],
"default" : "Off",
"type": "string"
},
"mtprgttfallback": {
"description": "System-wide option for MTP Routed GTT fallback, used to define error handling in case of failure for MTP routed MSUs.",
"enum" : [
"Mtproute",
"Gttfail"
],
"default" : "Mtproute",
"type": "string"
},
"reassemblyTimerDurationAnsi": {
"description": "Reassembly timer duration for ANSI domain. Time period after recieving the first segment, while waiting to recieve all the remaining segments related to same ANSI XUDT segmented message.",
"maximum": 20000,
"minimum": 5000,
"default": 5000,
"type": "integer"
},
"reassemblyTimerDurationItu": {
"description": "Reassembly timer duration for ITU domain. Time period after recieving the first segment, while waiting to recieve all the remaining segments related to same ITU XUDT segmented message.",
"maximum": 20000,
"minimum": 10000,
"default": 10000,
"type": "integer"
},
"segmentedMSULength": {
"description": "Length of Segmented MSU.",
"maximum": 272,
"minimum": 200,
"default": 200,
"type": "integer"
},
"smsDelivery": {
"description": "SMS Proxy Delivery Functionality Status.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"smsOrigination": {
"description": "SMS Proxy Origin Functionality Status.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"smsTermination": {
"description": "SMS Proxy Terminate Functionality Status.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"tcapErrorDiscard": {
"description": "TCAP Error Discard. If it is turned Off, MSU will be processed. While if it is turned on, MSU will be discarded.",
"enum": [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"tgtt0": {
"description": "When set to Udt, transaction-based GTT loadsharing is enabled for UDTS and Class0 UDT messages. When set to Xudt, transaction-based GTT loadsharing is enabled for XUDTS and Class0 XUDT messages. When set to Both, transaction-based GTT loadsharing is enabled for UDTS, XUDTS, Class0 UDT and Class0 XUDT messages. When set to None, transaction-based GTT loadsharing is disabled for UDTS, XUDTS, Class0 UDT and Class0 XUDT messages. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Both",
"None",
"Udt",
"Xudt"
],
"type": "string"
},
"tgtt1": {
"description": "When set to Udt, transaction-based GTT loadsharing is enabled for UDTS and Class1 UDT messages. When set to Xudt, transaction-based GTT loadsharing is enabled for XUDTS and Class1 XUDT messages. When set to Both, transaction-based GTT loadsharing is enabled for UDTS, XUDTS, Class1 UDT and XUDT messages. When set to None, transaction-based GTT loadsharing is disabled for UDTS, XUDTS, Class1 UDT and Class1 XUDT messages. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Both",
"None",
"Udt",
"Xudt"
],
"type": "string"
},
"tgttudtkey": {
"description": "Defines the transaction parameter for incoming UDT(S) messages. Messages with this parameter are routed to the same load-shared remote Point Code within a MAPGROUP or MRNGROUP. When set to Mtp, transaction-based GTT loadsharing is performed using the MTP algorithm. When set to Tcap, transaction-based GTT loadsharing is performed using the TCAP algorithm. When set to Sccp, transaction-based GTT loadsharing is performed using the SCCP algorithm. When set to Enhmtp, transaction-based GTT loadsharing is performed using the ENHMTP algorithm. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Enhmtp",
"Mtp",
"Sccp",
"Tcap"
],
"type": "string"
},
"tgttxudtkey": {
"description": "Defines the transaction parameter for incoming XUDT(S) messages. Messages with this parameter are routed to the same load-shared remote Point Code within a MAPGROUP or MRNGROUP. When set to Mtp, transaction-based GTT loadsharing is performed using the MTP algorithm. When set to Sccp, transaction-based GTT loadsharing is performed using the SCCP algorithm. When set to Enhmtp, transaction-based GTT loadsharing is performed using the ENHMTP algorithm. To update this parameter, the Transaction Based GTT Loadsharing feature must be enabled (using the GTT Feature Control (/vstp/featureadminstates)).",
"enum" : [
"Enhmtp",
"Mtp",
"Sccp"
],
"type": "string"
},
"travelVelocity": {
"description": "Defines the velocity of travelling.",
"maximum": 700,
"minimum": 1,
"type": "integer"
},
"allowedFirstSegLen": {
"description": "It specifies the allowed length of the first XUDT segment.",
"maximum": 272,
"minimum": 0,
"type": "integer"
}
},
"type": "object"
}
Example
{
"alwMsgDuringRsmblyErr": false,
"class1seq":"Disabled",
"dfltfallback": false,
"dfltgttmode": "Fcd",
"itun16ScmgEnabled": false,
"isSegXUDTfeatureEnable": false,
"mtprgtt": "Usemtppc",
"mtprgttfallback": "Gttfail",
"reassemblyTimerDurationAnsi": 5000,
"reassemblyTimerDurationItu": 10000,
"segmentedMSULength": 200,
"smsDelivery": "Off",
"smsOrigination": "Off",
"smsTermination": "Off",
"tcapErrorDiscard": "Off",
"tgtt0": "None",
"tgtt1": "None",
"tgttudtkey": "Mtp",
"tgttxudtkey": "Mtp"
}
Vstp: MNP Options
The Mobile Number Portability (MNP) Options are those configuration values that govern the overall MNP functionality . There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new MNP Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All MNP Options configuration is done at the SOAM.
/vstp/sccpmnpoptions
get /vstp/sccpmnpoptions
Returns the set of current values for the MNP Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sccpmnpoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpmnpoption/sccpmnpoption.json",
"properties": {
"aclen": {
"description": "The length of area code.",
"maximum": 8,
"minimum": 0,
"default": 0,
"type": "integer"
},
"cclen": {
"description": "The length of the country code.",
"maximum": 3,
"minimum": 0,
"default": 0,
"type": "integer"
},
"maplyrrtg_regss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Register Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_actss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Active Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_dactss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Deactivate Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_intss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Interrogate Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_procunstrqt": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Process Unstructured SS Request.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_sriloc": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Send Routing Information for LoCation Service",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_purgmobss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Purge Mobile Subscriber",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_rstdata": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Restore Data ",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_rdyforsm": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Ready For Short Message",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_authfailrpt": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Authentication Failure Report ",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"intlunknnai": {
"description": "This parameter specifies whether InternationalNAIs (nai=intl) are included in Unknown NAIs(nai=unkn) and should be considered forcountry code CgPN (cccgpn) conditioning.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mosmsbpartychk": {
"description": "MO-based B-Party Check.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"srfaddr": {
"description": "Entity address of the MNP_SRF node",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"srfnai": {
"description": "The nature of address indicator value of the MNP_SRF.",
"maximum": 127,
"minimum": 0,
"default": 0,
"type": "integer"
},
"srfnp": {
"description": "The numbering plan value of the MNP_SRF",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
},
"mosmsbpartygttset": {
"description": "MO SMS B-Party Routing GTT Set name. The GTT set where Global Title Translation lookup on B-Party digits is performed",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "None",
"type": "string"
},
"mosmsbpartychk": {
"description": "MO SMS B-Party PPSMS Check. This parameter specifies whether a prepaid check on the B-Party is performed on an incoming MO SMS message.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"mosmsdefrn": {
"description": "Default routing number. A default routing number used for own-network subscribers.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"mosmsaclen": {
"description": "The number of the digits that are taken from the MO SMS CgPA and used as the Area Code in the MO SMS CdPA",
"maximum": 8,
"minimum": 0,
"default": 0,
"type": "integer"
},
"mosmsdigmat": {
"description": "MO-based SMS Home SMSC match. The method used by the Portability Check for MO SMS or the MObased GSM SMS NP feature to find a Home SMSC match.",
"enum" : [
"exact",
"bestfit"
],
"default": "exact",
"type": "string"
},
"mosmsfwd": {
"description": "MO-based SMS forward. This parameter specifies whether the value of the SCCP CDPA in the MO-based SMS message is modified to the GTA value that is specified by the mosmsgta parameter.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mosmsgta": {
"description": "MO-based SMS GTA. The GTA value that is used to replace the SCCP CDPA value in the MO-based SMS message. This parameter can't be changed back to None once it is set other values.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]{5,21})$|^(None)$",
"type": "string"
},
"mosmsgttdig": {
"description": "MO SMS B-Party Routing GTT digits. The digits used for Global Title Translation.",
"enum" : [
"sccpcdpa",
"mapbparty"
],
"default": "sccpcdpa",
"type": "string"
},
"mosmsnai": {
"description": "MO-based SMS NAI. The number conditioning performed on the SMS message destination address before lookup in the number portability database is performed.",
"enum" : [
"intl",
"nai",
"nat",
"unknown"
],
"default": "intl",
"type": "string"
},
"mosmssa": {
"description": "MO-based SMS sub-address. This parameter specifies whether the sub-address is searched in the SMS called party (destination address)..",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mosmstcapseg": {
"description": "MO-based SMS TCAP Segmentation for GSM. This parameter specifies whether Mobile-Originated segmented TCAP messages are supported.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"mosmstype": {
"description": "MO-based SMS type. The value of the entity type that indicates that a successful lookup occurred in the number portability database.",
"enum" : [
"sp",
"rn",
"sprn",
"all"
],
"default": "sprn",
"type": "string"
},
"mosmsspfill": {
"description": "This parameter specifies whether the Numbering Plan Processor (NPP) can populate SP and RN entities for own network subscribers at the same time..",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"msrndig": {
"description": "The routing number to be used as is or concatenated with the MSISDN.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"rnccdn",
"rnasd",
"asdrn",
"rnasddn",
"asdrndn",
"ccrnasddn",
"ccasdrndn",
"rnasdccdn",
"asdrnccdn",
"rngrn",
"grnrn",
"rngrndn",
"grnrndn",
"ccrngrndn",
"ccgrnrndn",
"rngrnccdn",
"grnrnccdn"
],
"default" : "rn",
"type": "string"
},
"msrnlen": {
"description": "The number of digits in the MAP Routing Info portion of the returned SRI_ACK message.",
"maximum": 30,
"minimum": 1,
"default": 30,
"type": "integer"
},
"msrnnai": {
"description": "The nature of address indicator value for the MSRN.",
"maximum": 7,
"minimum": 0,
"default": 0,
"type": "integer"
},
"msrnnp": {
"description": "The numbering plan value for the MSRN.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
},
"msisdntrunc": {
"description": "MSISDN truncation digits.",
"maximum": 5,
"minimum": 0,
"default": 0,
"type": "integer"
},
"defmapvr": {
"description": "Default MAP version.",
"maximum": 3,
"minimum": 1,
"default": 1,
"type": "integer"
},
"sridn": {
"description": "The Send Routing Information Dialed Number location.",
"enum" : [
"tcap",
"sccp"
],
"default": "tcap",
"type": "string"
},
"multcc1": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc2": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc3": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc4": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc5": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc6": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc7": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc8": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc9": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc10": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"serverpfx": {
"description": "Server SRI prefix.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"sridnnotfound": {
"description": "The processing used when G-Port encounters an RTDB query result that indicates that the specified directory number is not known.",
"enum" : [
"gtt",
"srinack"
],
"default": "gtt",
"type": "string"
},
"crptt": {
"description": "Circular Route Prevention Translation Type.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^(None)$",
"type": "string"
},
"defcc": {
"description": "Default country code.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"defndc": {
"description": "Default network destination code.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"defmcc": {
"description": "E212 default mobile country code. It should support any 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{3}$|^(None)$",
"type": "string"
},
"defmnc": {
"description": "E212 default mobile network code. It should support any 2 or 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{2,3}$|^(None)$",
"type": "string"
},
"dngtzerofill": {
"description": "MT-Based SMS check source. This parameter specifies whether the SCCP CgPA GTA of a SRI_SM message is validated to determine if the source of the message is a Home SMSC.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"ccnc1-mccmnc1": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc2-mccmnc2": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc3-mccmnc3": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc4-mccmnc4": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc5-mccmnc5": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc6-mccmnc6": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc7-mccmnc7": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc8-mccmnc8": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc9-mccmnc9": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc10-mccmnc10": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"delccprefix": {
"description": "This parameter specifies how to apply the DELCCPREFIX digit action to a Called Party Global Title Address (CdPA GTA).",
"enum" : [
"pfxwcc",
"pfx4all"
],
"default": "pfxwcc",
"type": "string"
},
"encdnpsdnnotfound": {
"description": "Specifies whether the NPSI is included in SRI Ack messages when the DN is not found.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"encdnpsptnone": {
"description": "Specifies whether the NPSI is included in SRI Ack messages when the PT has a value of none (255).",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"encodecug": {
"description": "Specifies whether the Closed User Group (CUG) Checkinfo from the SRI message is included in the SRI Ack message.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"encodenps": {
"description": "Specifies whether the Number Portability Status Indicator (NPSI) is included in SRI Ack messages when the portability type (PT) has a value of 0, 1, 2 or 36.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"srismgttrtg": {
"description": "Specifies whether the SRI_SM routing feature is on.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"mtsmsimsi": {
"description": "MT-Based SMS IMSI. The required format of digits that are encoded in the 'IMSI' parameter of the SRI_SM response message.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"dn",
"srfimsi",
"mccrndn"
],
"default": "mccrndn",
"type": "string"
},
"mtsmsnni": {
"description": "MT-Based SMS network node indicator. The required format of digits that are encoded in the 'Network NodeNumber' parameter of the SRI_SM response message.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"dn",
"srfimsi",
"mccrndn",
"none"
],
"default": "rn",
"type": "string"
},
"mtsmstype": {
"description": "MT-Based SMS type. The value of the entity type that indicates that a successful lookup occurred in the number portability database for messages that are modified by the MT-Based GSM SMS NP feature.",
"enum" : [
"sp",
"rn",
"sprn",
"all",
"nonsp"
],
"default": "rn",
"type": "string"
},
"mtsmsackn": {
"description": "MT-Based SMS acknowledgement. The message generated in response to a successful number portability database lookup for an SRI_SM message from a Home SMSC.",
"enum" : [
"ack",
"nack"
],
"default": "ack",
"type": "string"
},
"mtsmsdltr": {
"description": "MT-Based SMS delimiter. This parameter specifies whether to insert a delimiter digit string before or after the routing number (RN) if the RN is used in the outbound digit format.",
"enum" : [
"no",
"prern",
"postrn"
],
"default": "no",
"type": "string"
},
"mtsmsdltrv": {
"description": "MT-Based SMS delimiter value. The delimiter digit string that is inserted before or after the RN when the RN is used in the outbound digit format.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"mtsmsnakerr": {
"description": "MT-Based SMS negative acknowledgement error. The TCAP error choice code used in the NACK response message generated for SRI_SM messages.",
"maximum": 255,
"minimum": 0,
"default": 1,
"type": "integer"
},
"mtsmschksrc": {
"description": "MT-Based SMS check source. This parameter specifies whether the SCCP CgPA GTA of a SRI_SM message is validated to determine if the source of the message is a Home SMSC.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mtsmsnp": {
"description": "Specifies whether the MT bases SMS NP feature is activated.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"mnpcrp": {
"description": "Specifies whether the MNP Circular Route feature is activated.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"mnpnpdbunavl": {
"description": "This option indicates action to be taken by MNP service when the Number Portability Database is Unavailable.",
"enum" : [
"discard",
"dnnotfound"
],
"default": "dnnotfound",
"type": "string"
},
"srvcrelaymapset": {
"description": "This option specifies the Load sharing MAPSET ID to be used for routing the MNP relayed messages.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0-2]?[0-9]{0,4})|(3[0-5][0-9]{0,3})|(36000))$|^(None)$",
"default": "None",
"type": "string"
},
"srismdn": {
"description": "SRI_SM DN location. This parameter specifies whether the MT-Based GSM SMS NP feature selects the MSISDN from the TCAP or SCCP CdPA section of the SRI_SM message.",
"enum" : [
"sccp",
"tcap"
],
"default": "sccp",
"type": "string"
},
"mtmmsgta": {
"description": "MT-Based MMS GTA. The GTA that is compared with the SCCP CgPA GTA of an SRI_SM message to determine whether the originator of the message is a Home MMSC.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]{5,21})$|^(None)$",
"type": "string"
},
"mtmmstype": {
"description": "MT-Based MMS type. The value of the entity type that indicates that a successful lookup occurred in the number portability database.",
"enum" : [
"sp",
"rn",
"sprn",
"all",
"nonsp"
],
"default": "rn",
"type": "string"
},
"mtmmsackn": {
"description": "MT-Based MMS acknowledgement. The message that is generated in response to a successful number portability database lookup for an SRI_SM message from a Home MMSC.",
"enum" : [
"ack",
"nack"
],
"default": "ack",
"type": "string"
},
"mtmmsentylen": {
"description": "MT-Based MMS Entity length. The maximum number of digits used from the entity value of a returned RN, SP, or SRFIMSI entity for Multimedia Service (MMS) processing.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0]?[0-9])|([1][0-5]))$|^(None)$",
"type": "string"
},
"mtmmslen": {
"description": "MT-Based MMS Length. The maximum number of digits used in the returned IMSI and/or NNI fields for MMS processing.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0]?[0-9])|([1][0-9])|([2][0-4]))$|^(None)$",
"type": "string"
},
"atiackimsi": {
"description": "ATIACK IMSI parameter for ATI ACK response message. This parameter specifies formatting of IMSI digits in the ATI ACK response message.",
"enum" : [
"srfimsi",
"asd",
"grn",
"none"
],
"default": "none",
"type": "string"
},
"atiackmsisdn": {
"description": "MSISDN parameter for ATI ACK response message. This parameter specifies the formatting of MSISDN parameter in the ATI ACK response message.",
"enum" : [
"msisdn",
"asd",
"asddlmmsisdn",
"grn",
"grndlmmsisdn",
"none"
],
"default": "msisdn",
"type": "string"
},
"atiackrn": {
"description": "Routing number parameter for ATI ACK response message. This parameter specifies the formatting of the routing number parameter in the ATI ACK response message.",
"enum" : [
"rn",
"rnsp",
"asddlmrnsp",
"rnspdlmasd",
"srfimsi",
"srfimsidlmasd",
"asddlmsrfimsi",
"grndlmrnsp",
"rnspdlmgrn",
"srfimsidlmgrn",
"grndlmsrfimsi",
"none"
],
"default": "rn",
"type": "string"
},
"atiackvlrnum": {
"description": "The formatting of the VLR-number in the ATI ACK response message.",
"enum" : [
"rn",
"rnsp",
"asddlmrnsp",
"rnspdlmasd",
"srfimsi",
"srfimsidlmasd",
"asddlmsrfimsi",
"grndlmrnsp",
"rnspdlmgrn",
"srfimsidlmgrn",
"grndlmsrfimsi",
"rnmsisdn",
"rnspmsisdn",
"msisdn",
"asd",
"asdmsisdn"
],
"default": "rnspmsisdn",
"type": "string"
},
"atidfltrn": {
"description": "Default Routing Number. The routing number to be used in outgoing message formats while encoding outgoing digit formats in the ATI ACK response in cases where an RN is not returned from an RTDB lookup.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"atidlm": {
"description": "Outbound message digits delimiter. This delimiter is used in outgoing message formats while encoding outbound digits in the ATI ACK response.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"atinptype": {
"description": "Number Portability Type. The criteria for a successful RTDB lookup.",
"enum" : [
"any",
"always"
],
"default": "any",
"type": "string"
},
"atientitylen": {
"description": "Entity Length. The maximum number of digits to be used from entity data (SRFIMSI or entity ID) in the specified encoding format.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0]?[0-9])|([1][0-9])|([2][0-4]))$|^(None)$",
"type": "string"
},
"atisupplocinfo": {
"description": "Specifies whether the Location Information shall be processed by ATINP subsystem or not.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"atisnai": {
"description": "Service NAI. The number conditioning that is performed on the MSISDN digits in the incoming ATI query message before RTDB lookup is performed.",
"enum" : [
"intl",
"nat",
"nai"
],
"default": "nai",
"type": "string"
},
"ativlrnumlen": {
"description": "The maximum number of digits that can be encoded as the VLR-number in ATI ACK message",
"maximum": 40,
"minimum": 1,
"default": 40,
"type": "integer"
},
"inpdranai": {
"description": "INPOPTS DRANAI Destination Routing Address Nature of Address Indicator.",
"maxLength": 7,
"pattern": "^((sub|natl|intl|unknown|ntwk)$)|^(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$",
"type": "string"
},
"inpdranp": {
"description": "INPOPTS Destination Routing Address Numbering Plan.",
"maxLength": 4,
"pattern": "^((E164|X121|F69)$)|^([0-7])$",
"type": "string"
},
"inpdra": {
"description": "INPTOPTS Destination Routing Address Format.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"rnnecdn",
"homerndn",
"rnasd",
"asdrn",
"rnasddn",
"asdrndn",
"ccrnasddn",
"ccasdrndn",
"asdrnccdn",
"rnasdccdn",
"rnasdnecdn",
"asdrnnecdn",
"rngrn",
"grnrn",
"rngrndn",
"grnrndn",
"ccrngrndn",
"ccgrnrndn",
"grnrnccdn",
"rngrnccdn",
"rngrnnecdn",
"grnrnnecdn",
"grn",
"grndn",
"ccgrndn"
],
"default": "rndn",
"type": "string"
},
"inpnec": {
"description": "National Escape Code.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"inprelcause": {
"description": "Release Cause to be used in RELEASECALL operation.",
"maximum": 127,
"minimum": 31,
"default": 1,
"type": "integer"
},
"inpcutnpaste": {
"description": "This parameter should appear immeditately following the DRA digits in the CONNECT response.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"inpsprestype": {
"description": "INP option that indicates the type of message the EAGLE is to send when an IDP message is received for INP service, the DN digits match, and the HLR ID is present.",
"enum" : [
"connect",
"continue"
],
"default": "continue",
"type": "string"
},
"inpsnai1-cdpanai1": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai2-cdpanai2": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai3-cdpanai3": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai4-cdpanai4": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai5-cdpanai5": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"gflexmaplayerrtg": {
"description": "G-Flex MAP layer routing. The message parameter used in the database lookup performed during G-Flex MAP layer routing.",
"enum" : [
"imsi",
"msisdn",
"all",
"none"
],
"default": "None",
"type": "string"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"atiackimsi": "none",
"atiackmsisdn": "msisdn",
"atiackrn": "rn",
"atiackvlrnum": "rnspmsisdn",
"atidfltrn": "None",
"atidlm": "None",
"atientitylen": "None",
"atinptype": "any",
"atisnai": "nai",
"atisupplocinfo": "Off",
"ativlrnumlen": 40,
"ccnc1-mccmnc1": "None",
"ccnc10-mccmnc10": "None",
"ccnc2-mccmnc2": "None",
"ccnc3-mccmnc3": "None",
"ccnc4-mccmnc4": "None",
"ccnc5-mccmnc5": "None",
"ccnc6-mccmnc6": "None",
"ccnc7-mccmnc7": "None",
"ccnc8-mccmnc8": "None",
"ccnc9-mccmnc9": "None",
"crptt": "None",
"defcc": "None",
"defmapvr": 1,
"defmcc": "None",
"defmnc": "None",
"defndc": "None",
"delccprefix": "pfxwcc",
"dngtzerofill": "No",
"encdnpsdnnotfound": "Off",
"encdnpsptnone": "Off",
"encodecug": "Off",
"encodenps": "On",
"gflexmaplayerrtg": "imsi",
"maplyrrtg_regss": "Off",
"maplyrrtg_actss": "Off",
"maplyrrtg_dactss": "Off",
"maplyrrtg_intss": "Off",
"maplyrrtg_procunstrqt": "Off",
"maplyrrtg_sriloc": "Off",
"maplyrrtg_purgmobss": "Off",
"maplyrrtg_rstdata": "Off",
"maplyrrtg_rdyforsm": "Off",
"maplyrrtg_authfailrpt": "Off",
"inpcutnpaste": "Off",
"inpdra": "rndn",
"inpdranai": "unknown",
"inpdranp": "1",
"inpnec": "None",
"inprelcause": 31,
"inpsnai1-cdpanai1": "None",
"inpsnai2-cdpanai2": "None",
"inpsnai3-cdpanai3": "None",
"inpsnai4-cdpanai4": "None",
"inpsnai5-cdpanai5": "None",
"maplyrrtg": [
{
"actss": true,
"authfailrpt": true,
"dactss": false,
"intss": true,
"procunstrqt": true,
"purgmobss": true,
"rdyforsm": false,
"regss": true,
"rstdata": false,
"sriloc": true
}
],
"mnpcrp": "Off",
"mnpnpdbunavl": "discard",
"srvcrelaymapset":"None",
"mosmsbpartygttset":"None",
"mosmsbpartychk":"Off",
"mosmsdefrn":"None",
"mosmsaclen":0,
"mosmsdigmat":"exact",
"mosmsfwd":"No",
"mosmsgta":"None",
"mosmsgttdig":"sccpcdpa",
"mosmsnai":"intl",
"mosmssa":"No",
"mosmstcapseg":"Off",
"mosmstype":"sprn",
"mosmsspfill":"Off",
"msisdntrunc": 0,
"msrndig": "rn",
"msrnlen": 30,
"msrnnai": 0,
"msrnnp": 0,
"mtmmsackn": "ack",
"mtmmsentylen": "None",
"mtmmsgta": "None",
"mtmmslen": "None",
"mtmmstype": "rn",
"mtsmsackn": "ack",
"mtsmschksrc": "No",
"mtsmsdltr": "no",
"mtsmsdltrv": "None",
"mtsmsimsi": "mccrndn",
"mtsmsnakerr": 1,
"mtsmsnni": "rn",
"mtsmsnp": "Off",
"mtsmstype": "rn",
"multcc1": "None",
"multcc10": "None",
"multcc2": "None",
"multcc3": "None",
"multcc4": "None",
"multcc5": "None",
"multcc6": "None",
"multcc7": "None",
"multcc8": "None",
"multcc9": "None",
"serverpfx": "None",
"srfaddr": "None",
"srfnai": 0,
"srfnp": 0,
"sridn": "tcap",
"sridnnotfound": "gtt",
"srismdn": "sccp",
"srismgttrtg": "Off"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/sccpmnpoptions
Update the MNP Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpmnpoption/sccpmnpoption.json",
"properties": {
"aclen": {
"description": "The length of area code.",
"maximum": 8,
"minimum": 0,
"default": 0,
"type": "integer"
},
"cclen": {
"description": "The length of the country code.",
"maximum": 3,
"minimum": 0,
"default": 0,
"type": "integer"
},
"maplyrrtg_regss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Register Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_actss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Active Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_dactss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Deactivate Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_intss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Interrogate Supplementary Service.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_procunstrqt": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Process Unstructured SS Request.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_sriloc": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Send Routing Information for LoCation Service",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_purgmobss": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Purge Mobile Subscriber",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_rstdata": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Restore Data ",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_rdyforsm": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Ready For Short Message",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"maplyrrtg_authfailrpt": {
"description": "This parameter is use to turn on/off G-flex MLR functionality for Authentication Failure Report ",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"intlunknnai": {
"description": "This parameter specifies whether InternationalNAIs (nai=intl) are included in Unknown NAIs(nai=unkn) and should be considered forcountry code CgPN (cccgpn) conditioning.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mosmsbpartychk": {
"description": "MO-based B-Party Check.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"srfaddr": {
"description": "Entity address of the MNP_SRF node",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"srfnai": {
"description": "The nature of address indicator value of the MNP_SRF.",
"maximum": 127,
"minimum": 0,
"default": 0,
"type": "integer"
},
"srfnp": {
"description": "The numbering plan value of the MNP_SRF",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
},
"mosmsbpartygttset": {
"description": "MO SMS B-Party Routing GTT Set name. The GTT set where Global Title Translation lookup on B-Party digits is performed",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"default": "None",
"type": "string"
},
"mosmsbpartychk": {
"description": "MO SMS B-Party PPSMS Check. This parameter specifies whether a prepaid check on the B-Party is performed on an incoming MO SMS message.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"mosmsdefrn": {
"description": "Default routing number. A default routing number used for own-network subscribers.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"mosmsaclen": {
"description": "The number of the digits that are taken from the MO SMS CgPA and used as the Area Code in the MO SMS CdPA",
"maximum": 8,
"minimum": 0,
"default": 0,
"type": "integer"
},
"mosmsdigmat": {
"description": "MO-based SMS Home SMSC match. The method used by the Portability Check for MO SMS or the MObased GSM SMS NP feature to find a Home SMSC match.",
"enum" : [
"exact",
"bestfit"
],
"default": "exact",
"type": "string"
},
"mosmsfwd": {
"description": "MO-based SMS forward. This parameter specifies whether the value of the SCCP CDPA in the MO-based SMS message is modified to the GTA value that is specified by the mosmsgta parameter.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mosmsgta": {
"description": "MO-based SMS GTA. The GTA value that is used to replace the SCCP CDPA value in the MO-based SMS message. This parameter can't be changed back to None once it is set other values.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]{5,21})$|^(None)$",
"type": "string"
},
"mosmsgttdig": {
"description": "MO SMS B-Party Routing GTT digits. The digits used for Global Title Translation.",
"enum" : [
"sccpcdpa",
"mapbparty"
],
"default": "sccpcdpa",
"type": "string"
},
"mosmsnai": {
"description": "MO-based SMS NAI. The number conditioning performed on the SMS message destination address before lookup in the number portability database is performed.",
"enum" : [
"intl",
"nai",
"nat",
"unknown"
],
"default": "intl",
"type": "string"
},
"mosmssa": {
"description": "MO-based SMS sub-address. This parameter specifies whether the sub-address is searched in the SMS called party (destination address)..",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mosmstcapseg": {
"description": "MO-based SMS TCAP Segmentation for GSM. This parameter specifies whether Mobile-Originated segmented TCAP messages are supported.",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"mosmstype": {
"description": "MO-based SMS type. The value of the entity type that indicates that a successful lookup occurred in the number portability database.",
"enum" : [
"sp",
"rn",
"sprn",
"all"
],
"default": "sprn",
"type": "string"
},
"mosmsspfill": {
"description": "This parameter specifies whether the Numbering Plan Processor (NPP) can populate SP and RN entities for own network subscribers at the same time..",
"enum" : [
"On",
"Off"
],
"default": "Off",
"type": "string"
},
"msrndig": {
"description": "The routing number to be used as is or concatenated with the MSISDN.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"rnccdn",
"rnasd",
"asdrn",
"rnasddn",
"asdrndn",
"ccrnasddn",
"ccasdrndn",
"rnasdccdn",
"asdrnccdn",
"rngrn",
"grnrn",
"rngrndn",
"grnrndn",
"ccrngrndn",
"ccgrnrndn",
"rngrnccdn",
"grnrnccdn"
],
"default" : "rn",
"type": "string"
},
"msrnlen": {
"description": "The number of digits in the MAP Routing Info portion of the returned SRI_ACK message.",
"maximum": 30,
"minimum": 1,
"default": 30,
"type": "integer"
},
"msrnnai": {
"description": "The nature of address indicator value for the MSRN.",
"maximum": 7,
"minimum": 0,
"default": 0,
"type": "integer"
},
"msrnnp": {
"description": "The numbering plan value for the MSRN.",
"maximum": 15,
"minimum": 0,
"default": 0,
"type": "integer"
},
"msisdntrunc": {
"description": "MSISDN truncation digits.",
"maximum": 5,
"minimum": 0,
"default": 0,
"type": "integer"
},
"defmapvr": {
"description": "Default MAP version.",
"maximum": 3,
"minimum": 1,
"default": 1,
"type": "integer"
},
"sridn": {
"description": "The Send Routing Information Dialed Number location.",
"enum" : [
"tcap",
"sccp"
],
"default": "tcap",
"type": "string"
},
"multcc1": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc2": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc3": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc4": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc5": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc6": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc7": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc8": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc9": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"multcc10": {
"description": "Multiple country code.MaxLength is 3 for numeric data or None.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"serverpfx": {
"description": "Server SRI prefix.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"sridnnotfound": {
"description": "The processing used when G-Port encounters an RTDB query result that indicates that the specified directory number is not known.",
"enum" : [
"gtt",
"srinack"
],
"default": "gtt",
"type": "string"
},
"crptt": {
"description": "Circular Route Prevention Translation Type.",
"maxLength": 4,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^(None)$",
"type": "string"
},
"defcc": {
"description": "Default country code.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"defndc": {
"description": "Default network destination code.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"defmcc": {
"description": "E212 default mobile country code. It should support any 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{3}$|^(None)$",
"type": "string"
},
"defmnc": {
"description": "E212 default mobile network code. It should support any 2 or 3 digits hexa-decimal number or None.",
"maxLength": 4,
"pattern": "^[a-fA-F0-9]{2,3}$|^(None)$",
"type": "string"
},
"dngtzerofill": {
"description": "MT-Based SMS check source. This parameter specifies whether the SCCP CgPA GTA of a SRI_SM message is validated to determine if the source of the message is a Home SMSC.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"ccnc1-mccmnc1": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc2-mccmnc2": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc3-mccmnc3": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc4-mccmnc4": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc5-mccmnc5": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc6-mccmnc6": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc7-mccmnc7": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc8-mccmnc8": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc9-mccmnc9": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"ccnc10-mccmnc10": {
"description": "Combination of E214 country code/network code and E212 mobile country code/mobile network code. The values for ccnc and mccmnc must be separated by a hyphen (-). 'None' must be specified to unconfigure this parameter.",
"maxLength": 16,
"pattern": "^(([0-9]{2,8})(-){1}([a-fA-F0-9]{4,7})$)|^(None)$",
"type": "string"
},
"delccprefix": {
"description": "This parameter specifies how to apply the DELCCPREFIX digit action to a Called Party Global Title Address (CdPA GTA).",
"enum" : [
"pfxwcc",
"pfx4all"
],
"default": "pfxwcc",
"type": "string"
},
"encdnpsdnnotfound": {
"description": "Specifies whether the NPSI is included in SRI Ack messages when the DN is not found.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"encdnpsptnone": {
"description": "Specifies whether the NPSI is included in SRI Ack messages when the PT has a value of none (255).",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"encodecug": {
"description": "Specifies whether the Closed User Group (CUG) Checkinfo from the SRI message is included in the SRI Ack message.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"encodenps": {
"description": "Specifies whether the Number Portability Status Indicator (NPSI) is included in SRI Ack messages when the portability type (PT) has a value of 0, 1, 2 or 36.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"srismgttrtg": {
"description": "Specifies whether the SRI_SM routing feature is on.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"mtsmsimsi": {
"description": "MT-Based SMS IMSI. The required format of digits that are encoded in the 'IMSI' parameter of the SRI_SM response message.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"dn",
"srfimsi",
"mccrndn"
],
"default": "mccrndn",
"type": "string"
},
"mtsmsnni": {
"description": "MT-Based SMS network node indicator. The required format of digits that are encoded in the 'Network NodeNumber' parameter of the SRI_SM response message.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"dn",
"srfimsi",
"mccrndn",
"none"
],
"default": "rn",
"type": "string"
},
"mtsmstype": {
"description": "MT-Based SMS type. The value of the entity type that indicates that a successful lookup occurred in the number portability database for messages that are modified by the MT-Based GSM SMS NP feature.",
"enum" : [
"sp",
"rn",
"sprn",
"all",
"nonsp"
],
"default": "rn",
"type": "string"
},
"mtsmsackn": {
"description": "MT-Based SMS acknowledgement. The message generated in response to a successful number portability database lookup for an SRI_SM message from a Home SMSC.",
"enum" : [
"ack",
"nack"
],
"default": "ack",
"type": "string"
},
"mtsmsdltr": {
"description": "MT-Based SMS delimiter. This parameter specifies whether to insert a delimiter digit string before or after the routing number (RN) if the RN is used in the outbound digit format.",
"enum" : [
"no",
"prern",
"postrn"
],
"default": "no",
"type": "string"
},
"mtsmsdltrv": {
"description": "MT-Based SMS delimiter value. The delimiter digit string that is inserted before or after the RN when the RN is used in the outbound digit format.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"mtsmsnakerr": {
"description": "MT-Based SMS negative acknowledgement error. The TCAP error choice code used in the NACK response message generated for SRI_SM messages.",
"maximum": 255,
"minimum": 0,
"default": 1,
"type": "integer"
},
"mtsmschksrc": {
"description": "MT-Based SMS check source. This parameter specifies whether the SCCP CgPA GTA of a SRI_SM message is validated to determine if the source of the message is a Home SMSC.",
"enum" : [
"No",
"Yes"
],
"default": "No",
"type": "string"
},
"mtsmsnp": {
"description": "Specifies whether the MT bases SMS NP feature is activated.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"mnpcrp": {
"description": "Specifies whether the MNP Circular Route feature is activated.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"mnpnpdbunavl": {
"description": "This option indicates action to be taken by MNP service when the Number Portability Database is Unavailable.",
"enum" : [
"discard",
"dnnotfound"
],
"default": "dnnotfound",
"type": "string"
},
"srvcrelaymapset": {
"description": "This option specifies the Load sharing MAPSET ID to be used for routing the MNP relayed messages.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0-2]?[0-9]{0,4})|(3[0-5][0-9]{0,3})|(36000))$|^(None)$",
"default": "None",
"type": "string"
},
"srismdn": {
"description": "SRI_SM DN location. This parameter specifies whether the MT-Based GSM SMS NP feature selects the MSISDN from the TCAP or SCCP CdPA section of the SRI_SM message.",
"enum" : [
"sccp",
"tcap"
],
"default": "sccp",
"type": "string"
},
"mtmmsgta": {
"description": "MT-Based MMS GTA. The GTA that is compared with the SCCP CgPA GTA of an SRI_SM message to determine whether the originator of the message is a Home MMSC.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]{5,21})$|^(None)$",
"type": "string"
},
"mtmmstype": {
"description": "MT-Based MMS type. The value of the entity type that indicates that a successful lookup occurred in the number portability database.",
"enum" : [
"sp",
"rn",
"sprn",
"all",
"nonsp"
],
"default": "rn",
"type": "string"
},
"mtmmsackn": {
"description": "MT-Based MMS acknowledgement. The message that is generated in response to a successful number portability database lookup for an SRI_SM message from a Home MMSC.",
"enum" : [
"ack",
"nack"
],
"default": "ack",
"type": "string"
},
"mtmmsentylen": {
"description": "MT-Based MMS Entity length. The maximum number of digits used from the entity value of a returned RN, SP, or SRFIMSI entity for Multimedia Service (MMS) processing.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0]?[0-9])|([1][0-5]))$|^(None)$",
"type": "string"
},
"mtmmslen": {
"description": "MT-Based MMS Length. The maximum number of digits used in the returned IMSI and/or NNI fields for MMS processing.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0]?[0-9])|([1][0-9])|([2][0-4]))$|^(None)$",
"type": "string"
},
"atiackimsi": {
"description": "ATIACK IMSI parameter for ATI ACK response message. This parameter specifies formatting of IMSI digits in the ATI ACK response message.",
"enum" : [
"srfimsi",
"asd",
"grn",
"none"
],
"default": "none",
"type": "string"
},
"atiackmsisdn": {
"description": "MSISDN parameter for ATI ACK response message. This parameter specifies the formatting of MSISDN parameter in the ATI ACK response message.",
"enum" : [
"msisdn",
"asd",
"asddlmmsisdn",
"grn",
"grndlmmsisdn",
"none"
],
"default": "msisdn",
"type": "string"
},
"atiackrn": {
"description": "Routing number parameter for ATI ACK response message. This parameter specifies the formatting of the routing number parameter in the ATI ACK response message.",
"enum" : [
"rn",
"rnsp",
"asddlmrnsp",
"rnspdlmasd",
"srfimsi",
"srfimsidlmasd",
"asddlmsrfimsi",
"grndlmrnsp",
"rnspdlmgrn",
"srfimsidlmgrn",
"grndlmsrfimsi",
"none"
],
"default": "rn",
"type": "string"
},
"atiackvlrnum": {
"description": "The formatting of the VLR-number in the ATI ACK response message.",
"enum" : [
"rn",
"rnsp",
"asddlmrnsp",
"rnspdlmasd",
"srfimsi",
"srfimsidlmasd",
"asddlmsrfimsi",
"grndlmrnsp",
"rnspdlmgrn",
"srfimsidlmgrn",
"grndlmsrfimsi",
"rnmsisdn",
"rnspmsisdn",
"msisdn",
"asd",
"asdmsisdn"
],
"default": "rnspmsisdn",
"type": "string"
},
"atidfltrn": {
"description": "Default Routing Number. The routing number to be used in outgoing message formats while encoding outgoing digit formats in the ATI ACK response in cases where an RN is not returned from an RTDB lookup.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"atidlm": {
"description": "Outbound message digits delimiter. This delimiter is used in outgoing message formats while encoding outbound digits in the ATI ACK response.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"atinptype": {
"description": "Number Portability Type. The criteria for a successful RTDB lookup.",
"enum" : [
"any",
"always"
],
"default": "any",
"type": "string"
},
"atientitylen": {
"description": "Entity Length. The maximum number of digits to be used from entity data (SRFIMSI or entity ID) in the specified encoding format.",
"maxLength": 4,
"pattern": "^(?!(0+)$)^(([0]?[0-9])|([1][0-9])|([2][0-4]))$|^(None)$",
"type": "string"
},
"atisupplocinfo": {
"description": "Specifies whether the Location Information shall be processed by ATINP subsystem or not.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"atisnai": {
"description": "Service NAI. The number conditioning that is performed on the MSISDN digits in the incoming ATI query message before RTDB lookup is performed.",
"enum" : [
"intl",
"nat",
"nai"
],
"default": "nai",
"type": "string"
},
"ativlrnumlen": {
"description": "The maximum number of digits that can be encoded as the VLR-number in ATI ACK message",
"maximum": 40,
"minimum": 1,
"default": 40,
"type": "integer"
},
"inpdranai": {
"description": "INPOPTS DRANAI Destination Routing Address Nature of Address Indicator.",
"maxLength": 7,
"pattern": "^((sub|natl|intl|unknown|ntwk)$)|^(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$",
"type": "string"
},
"inpdranp": {
"description": "INPOPTS Destination Routing Address Numbering Plan.",
"maxLength": 4,
"pattern": "^((E164|X121|F69)$)|^([0-7])$",
"type": "string"
},
"inpdra": {
"description": "INPTOPTS Destination Routing Address Format.",
"enum" : [
"rn",
"rndn",
"ccrndn",
"rnnecdn",
"homerndn",
"rnasd",
"asdrn",
"rnasddn",
"asdrndn",
"ccrnasddn",
"ccasdrndn",
"asdrnccdn",
"rnasdccdn",
"rnasdnecdn",
"asdrnnecdn",
"rngrn",
"grnrn",
"rngrndn",
"grnrndn",
"ccrngrndn",
"ccgrnrndn",
"grnrnccdn",
"rngrnccdn",
"rngrnnecdn",
"grnrnnecdn",
"grn",
"grndn",
"ccgrndn"
],
"default": "rndn",
"type": "string"
},
"inpnec": {
"description": "National Escape Code.",
"maxLength": 5,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
},
"inprelcause": {
"description": "Release Cause to be used in RELEASECALL operation.",
"maximum": 127,
"minimum": 31,
"default": 1,
"type": "integer"
},
"inpcutnpaste": {
"description": "This parameter should appear immeditately following the DRA digits in the CONNECT response.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"inpsprestype": {
"description": "INP option that indicates the type of message the EAGLE is to send when an IDP message is received for INP service, the DN digits match, and the HLR ID is present.",
"enum" : [
"connect",
"continue"
],
"default": "continue",
"type": "string"
},
"inpsnai1-cdpanai1": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai2-cdpanai2": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai3-cdpanai3": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai4-cdpanai4": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"inpsnai5-cdpanai5": {
"description": "Combination of Service Nature of Address Indicator and Called Party Number Nature of Address Indicator. The values for snai and cdpanai must be separated by a hyphen (-). Allowable values for inpsnai1 are [sub,natl,intl,unknown,none] and for cdpanai the range is 0 to 127. 'None' must be specified to unconfigure this parameter.",
"maxLength": 11,
"pattern": "^((sub|natl|intl|unknown|none){1}(-){1}(([0-9]?[0-9])|([1][0-2][0-7])|(12[0-7]))$)|^(None)$",
"type": "string"
},
"gflexmaplayerrtg": {
"description": "G-Flex MAP layer routing. The message parameter used in the database lookup performed during G-Flex MAP layer routing.",
"enum" : [
"imsi",
"msisdn",
"all",
"none"
],
"default": "None",
"type": "string"
}
},
"required": [],
"type": "object"
}
Example
{
"atiackimsi": "none",
"atiackmsisdn": "msisdn",
"atiackrn": "rn",
"atiackvlrnum": "rnspmsisdn",
"atidfltrn": "None",
"atidlm": "None",
"atientitylen": "None",
"atinptype": "any",
"atisnai": "nai",
"atisupplocinfo": "Off",
"ativlrnumlen": 40,
"ccnc1-mccmnc1": "None",
"ccnc10-mccmnc10": "None",
"ccnc2-mccmnc2": "None",
"ccnc3-mccmnc3": "None",
"ccnc4-mccmnc4": "None",
"ccnc5-mccmnc5": "None",
"ccnc6-mccmnc6": "None",
"ccnc7-mccmnc7": "None",
"ccnc8-mccmnc8": "None",
"ccnc9-mccmnc9": "None",
"crptt": "None",
"defcc": "None",
"defmapvr": 1,
"defmcc": "None",
"defmnc": "None",
"defndc": "None",
"delccprefix": "pfxwcc",
"dngtzerofill": "No",
"encdnpsdnnotfound": "Off",
"encdnpsptnone": "Off",
"encodecug": "Off",
"encodenps": "On",
"gflexmaplayerrtg": "imsi",
"maplyrrtg_regss": "Off",
"maplyrrtg_actss": "Off",
"maplyrrtg_dactss": "Off",
"maplyrrtg_intss": "Off",
"maplyrrtg_procunstrqt": "Off",
"maplyrrtg_sriloc": "Off",
"maplyrrtg_purgmobss": "Off",
"maplyrrtg_rstdata": "Off",
"maplyrrtg_rdyforsm": "Off",
"maplyrrtg_authfailrpt": "Off",
"inpcutnpaste": "Off",
"inpdra": "rndn",
"inpdranai": "unknown",
"inpdranp": "1",
"inpnec": "None",
"inprelcause": 31,
"inpsnai1-cdpanai1": "None",
"inpsnai2-cdpanai2": "None",
"inpsnai3-cdpanai3": "None",
"inpsnai4-cdpanai4": "None",
"inpsnai5-cdpanai5": "None",
"maplyrrtg": [
{
"actss": true,
"authfailrpt": true,
"dactss": false,
"intss": true,
"procunstrqt": true,
"purgmobss": true,
"rdyforsm": false,
"regss": true,
"rstdata": false,
"sriloc": true
}
],
"mnpcrp": "Off",
"mnpnpdbunavl": "discard",
"srvcrelaymapset":"None",
"mosmsbpartygttset":"None",
"mosmsbpartychk":"Off",
"mosmsdefrn":"None",
"mosmsaclen":0,
"mosmsdigmat":"exact",
"mosmsfwd":"No",
"mosmsgta":"None",
"mosmsgttdig":"sccpcdpa",
"mosmsnai":"intl",
"mosmssa":"No",
"mosmstcapseg":"Off",
"mosmstype":"sprn",
"mosmsspfill":"Off",
"msisdntrunc": 0,
"msrndig": "rn",
"msrnlen": 30,
"msrnnai": 0,
"msrnnp": 0,
"mtmmsackn": "ack",
"mtmmsentylen": "None",
"mtmmsgta": "None",
"mtmmslen": "None",
"mtmmstype": "rn",
"mtsmsackn": "ack",
"mtsmschksrc": "No",
"mtsmsdltr": "no",
"mtsmsdltrv": "None",
"mtsmsimsi": "mccrndn",
"mtsmsnakerr": 1,
"mtsmsnni": "rn",
"mtsmsnp": "Off",
"mtsmstype": "rn",
"multcc1": "None",
"multcc10": "None",
"multcc2": "None",
"multcc3": "None",
"multcc4": "None",
"multcc5": "None",
"multcc6": "None",
"multcc7": "None",
"multcc8": "None",
"multcc9": "None",
"serverpfx": "None",
"srfaddr": "None",
"srfnai": 0,
"srfnp": 0,
"sridn": "tcap",
"sridnnotfound": "gtt",
"srismdn": "sccp",
"srismgttrtg": "Off"
}
Vstp: Sccp Service Selectors
A Sccp Service Selector is an entity assigned to a Sccp Service.
All configuration of Sccp Service Selector is done at the SOAM.
/vstp/sccpserviceselectors
get /vstp/sccpserviceselectors
Returns all Sccp Service Selectors that meet the criteria specified in the GET request. By default, all Sccp Service Selector configured at the SOAM are returned. If paging parameters are supplied, only those Sccp Service Selectors meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/sccpserviceselectorCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpserviceselector/sccpserviceselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24"
],
"type": "string"
},
"gttRequired": {
"description": "Defines if message should fallback to GTT after Service",
"type": "boolean",
"default": false
},
"globalTitleIndicator": {
"description": "Global Title Indicator Conversion.",
"enum": [
"TtOnly",
"TtNumEncodingNature"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp Service Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"serviceName": {
"description": "Service Name Associated with service.",
"enum": [
"Eir",
"Inpq",
"Atinp",
"Gport",
"Idpr",
"Mosms",
"Gflex",
"Idps"
],
"type": "string"
},
"serviceNai": {
"description": "Defines the Service Interprated Nature of address Indicator.",
"enum": [
"Ccrndn",
"Intl",
"Natl",
"Rnidn",
"Rnndn",
"Rnsdn",
"Sub",
"Unknown"
],
"type": "string"
},
"serviceNP": {
"description": "Defines Service Interprated Numbering Plan",
"enum": [
"E164",
"E212",
"E214"
],
"type": "string"
},
"ssn": {
"description": "Service Subsystem number.",
"maxLength": 255,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"translationType": {
"description": "Defines the translation type (TT) for this Service Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator",
"ssn",
"translationType",
"serviceName"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"configurationLevel": "0",
"domain": "Itui",
"gttRequired":false,
"globalTitleIndicator":"TtNumEncodingNature",
"serviceName": "Mosms",
"name": "SrvcSel1",
"natureOfAddressIndicatorValue": 4,
"ssn": "22",
"serviceNai": "Sub",
"serviceNP": "E164",
"numberingPlanValue": 3,
"translationType": 2
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/sccpserviceselectors
Adds a new Sccp Service Selector to the VSTP configuration. The Sccp Service Selector name must be unique as it refers to the Service name at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpserviceselector/sccpserviceselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24"
],
"type": "string"
},
"gttRequired": {
"description": "Defines if message should fallback to GTT after Service",
"type": "boolean",
"default": false
},
"globalTitleIndicator": {
"description": "Global Title Indicator Conversion.",
"enum": [
"TtOnly",
"TtNumEncodingNature"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp Service Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"serviceName": {
"description": "Service Name Associated with service.",
"enum": [
"Eir",
"Inpq",
"Atinp",
"Gport",
"Idpr",
"Mosms",
"Gflex",
"Idps"
],
"type": "string"
},
"serviceNai": {
"description": "Defines the Service Interprated Nature of address Indicator.",
"enum": [
"Ccrndn",
"Intl",
"Natl",
"Rnidn",
"Rnndn",
"Rnsdn",
"Sub",
"Unknown"
],
"type": "string"
},
"serviceNP": {
"description": "Defines Service Interprated Numbering Plan",
"enum": [
"E164",
"E212",
"E214"
],
"type": "string"
},
"ssn": {
"description": "Service Subsystem number.",
"maxLength": 255,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"translationType": {
"description": "Defines the translation type (TT) for this Service Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator",
"ssn",
"translationType",
"serviceName"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"domain": "Itui",
"gttRequired":false,
"globalTitleIndicator":"TtNumEncodingNature",
"serviceName": "Mosms",
"name": "SrvcSel1",
"natureOfAddressIndicatorValue": 4,
"ssn": "22",
"serviceNai": "Sub",
"serviceNP": "E164",
"numberingPlanValue": 3,
"translationType": 2
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/sccpserviceselectors/{name}
get /vstp/sccpserviceselectors/{name}
Returns the configuration details for the specified Sccp Service Selector. If the Service does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sccpserviceselectorItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpserviceselector/sccpserviceselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24"
],
"type": "string"
},
"gttRequired": {
"description": "Defines if message should fallback to GTT after Service",
"type": "boolean",
"default": false
},
"globalTitleIndicator": {
"description": "Global Title Indicator Conversion.",
"enum": [
"TtOnly",
"TtNumEncodingNature"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp Service Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"serviceName": {
"description": "Service Name Associated with service.",
"enum": [
"Eir",
"Inpq",
"Atinp",
"Gport",
"Idpr",
"Mosms",
"Gflex",
"Idps"
],
"type": "string"
},
"serviceNai": {
"description": "Defines the Service Interprated Nature of address Indicator.",
"enum": [
"Ccrndn",
"Intl",
"Natl",
"Rnidn",
"Rnndn",
"Rnsdn",
"Sub",
"Unknown"
],
"type": "string"
},
"serviceNP": {
"description": "Defines Service Interprated Numbering Plan",
"enum": [
"E164",
"E212",
"E214"
],
"type": "string"
},
"ssn": {
"description": "Service Subsystem number.",
"maxLength": 255,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"translationType": {
"description": "Defines the translation type (TT) for this Service Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator",
"ssn",
"translationType",
"serviceName"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"configurationLevel": "0",
"domain": "Itui",
"gttRequired":false,
"globalTitleIndicator":"TtNumEncodingNature",
"serviceName": "Mosms",
"name": "SrvcSel1",
"natureOfAddressIndicatorValue": 4,
"ssn": "22",
"serviceNai": "Sub",
"serviceNP": "E164",
"numberingPlanValue": 3,
"translationType": 2
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/sccpserviceselectors/{name}
Updates the configuration of the specified Sccp Service Selector. If the provided Service Selector data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sccpserviceselector/sccpserviceselector.json",
"properties": {
"configurationLevel": {
"description": "The configuration level of the database when this instance is inserted or updated. configurationLevel is read-only.",
"format": "int64",
"readOnly": true,
"type": "string"
},
"domain": {
"description": "Defines the type of incoming message network domain. Default is Ansi.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24"
],
"type": "string"
},
"gttRequired": {
"description": "Defines if message should fallback to GTT after Service",
"type": "boolean",
"default": false
},
"globalTitleIndicator": {
"description": "Global Title Indicator Conversion.",
"enum": [
"TtOnly",
"TtNumEncodingNature"
],
"type": "string"
},
"name": {
"description": "Name for this Sccp Service Selector. Valid names are strings between one and 10 characters, inclusive. Valid characters are alphanumeric and underscore. The name must contain at least one alpha and must not start with a digit.",
"maxLength": 9,
"pattern": "^(([A-Za-z][A-Za-z0-9_]*)|(_[A-Za-z0-9_]*[A-Za-z][A-Za-z0-9_]*))$",
"type": "string"
},
"natureOfAddressIndicator": {
"description": "Defines Nature of Address indicator for this GTT Selector. When set to International, then Nature of Address indicator (NAI) is International number. When set to National, then Nature of Address indicator (NAI) is National significant number. When set to Reserved, then Nature of Address indicator (NAI) is Reserverd for National use. When set to Subscriber, then Nature of Address indicator (NAI) is Subscriber Number. Either natureOfAddressIndicator or natureOfAddressIndicatorValue can be specified at a time.",
"enum": [
"International",
"National",
"Reserved",
"Subscriber"
],
"type": "string"
},
"natureOfAddressIndicatorValue": {
"description": "Value for the nature of Address indicator. Value 1 refers to Subscriber natureOfAddressIndicator, value 2 refers to Reserved natureOfAddressIndicator, value 3 refers to National natureOfAddressIndicator, value 4 refers to International natureOfAddressIndicator, value 5-127 refer to spare values, value 0 refers to unknown natureOfAddressIndicator. There is no enum corresponding to 0 and 5-127 range. For these values, only natureOfAddressIndicatorValue can be set.",
"maximum": 127,
"minimum": 0,
"type": "integer"
},
"numberingPlan": {
"description": "Defines Numbering plan (NP) for this GTT Selector. When set to E164, then Numbering plan is ISDN/telephony numbering plan. When set to X121, then Numbering plan is Data numbering plan. When set to F69, then Numbering plan is Telex numbering plan. When set to E210, then Numbering plan is Maritime mobile numbering plan. When set to E212, then Numbering plan is Land mobile numbering plan. When set to E214, then Numbering plan is ISDN/mobile numbering plan. When set to Private, then Numbering plan is Private network or network-specific numbering plan. When set to Generic, then Numbering plan is Generic numbering plan. Either numberingPlan or numberingPlanValue can be specified at a time.",
"enum": [
"E164",
"E210",
"E212",
"E214",
"F69",
"Generic",
"Private",
"X121"
],
"type": "string"
},
"numberingPlanValue": {
"description": "Value for the numbering plan. Value 1 refers to Isdn numberingPlanValue, value 2 refers to Generic numberingPlanValue, value 3 refers to Data numberingPlanValue, value 4 refers to Telex numberingPlanValue, value 5 refers to Maritime numberingPlanValue, value 6 refers to Land, value 7 refers to IsdnMobile numberingPlanValue, value 8 refers to Private numberingPlanValue, value 9-15 refers to Spare nnumberingPlanValue and value 0 refer to Unknown numberingPlanValue. There is no enum corresponding to 0 and 9-15 range. For these values, only numberingPlanValue can be set.",
"maximum": 15,
"minimum": 0,
"type": "integer"
},
"serviceName": {
"description": "Service Name Associated with service.",
"enum": [
"Eir",
"Inpq",
"Atinp",
"Gport",
"Idpr",
"Mosms",
"Gflex",
"Idps"
],
"type": "string"
},
"serviceNai": {
"description": "Defines the Service Interprated Nature of address Indicator.",
"enum": [
"Ccrndn",
"Intl",
"Natl",
"Rnidn",
"Rnndn",
"Rnsdn",
"Sub",
"Unknown"
],
"type": "string"
},
"serviceNP": {
"description": "Defines Service Interprated Numbering Plan",
"enum": [
"E164",
"E212",
"E214"
],
"type": "string"
},
"ssn": {
"description": "Service Subsystem number.",
"maxLength": 255,
"pattern": "^(([0-1]?[0-9]?[0-9])|([2][0-4][0-9])|(25[0-5]))$|^[*]$",
"type": "string"
},
"translationType": {
"description": "Defines the translation type (TT) for this Service Selector.",
"maximum": 255,
"minimum": 0,
"type": "integer"
}
},
"required": [
"domain",
"name",
"globalTitleIndicator",
"ssn",
"translationType",
"serviceName"
],
"type": "object"
}
Example
{
"configurationLevel": "0",
"domain": "Itui",
"gttRequired":false,
"globalTitleIndicator":"TtNumEncodingNature",
"serviceName": "Mosms",
"name": "SrvcSel1",
"natureOfAddressIndicatorValue": 4,
"ssn": "22",
"serviceNai": "Sub",
"serviceNP": "E164",
"numberingPlanValue": 3,
"translationType": 2
}
delete /vstp/sccpserviceselectors/{name}
Deletes the specified Sccp Service Selector from the SOAM configuration. A Service Selector can only be deleted if all delete validation checks pass. In general, if the Sccp Service Selector is associated with a Service , the Sccp Service Selector cannot be deleted. An attempt to delete a Sccp Service Selector that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Security Log Config
The Security Log Config maintains all configuration values that governs the functionality of security logging in the file directory of SOAM.
All configurations of Security Log Config is done at the SOAM.
/vstp/securitylogconfig
get /vstp/securitylogconfig
Returns the set of current values for the Security Log Config.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/securitylogconfigItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/securitylogconfig/securitylogconfig.json",
"properties": {
"securityLoggingFeature": {
"description": "Global Parameter for Security Logging feature which should be enabled before provisioning any logging task.",
"enum" : [
"On",
"Off"
],
"default" : "Off",
"type": "string"
},
"siteIdentifier": {
"description": "Parameter to identify logging site.",
"maxLength": 20,
"minLength": 0,
"pattern": "^[a-zA-Z_0-9-]*$",
"default": "",
"type": "string"
},
"logMpDirPath": {
"description": "Directory path of MP for logging",
"maxLength": 300,
"minLength": 1,
"pattern": "^(\/[a-zA-Z_0-9-]*)+$",
"default": "/var/TKLC/db/filemgmt/securityLog/",
"type": "string"
},
"logFileTimeout": {
"description": "Timeout in seconds after which new file will be created for logging",
"maximum": 120,
"minimum": 60,
"default": 90,
"type": "integer"
},
"maxLogsPerFile": {
"description": "Maximum logs to be created per file, after which new file would be created",
"maximum": 3000000,
"minimum": 600000,
"default": 1500000,
"type": "integer"
},
"minDiskSpaceForLogging": {
"description": "Minimum available disk space in current directory filesystem to be allocated for logging",
"maximum": 100,
"minimum": 10,
"default": 30,
"type": "integer"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"logMpDirPath": "/var/TKLC/db/filemgmt/securityLog/",
"logFileTimeout": 120,
"maxLogsPerFile": 1000000,
"minDiskSpaceForLogging": 30
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/securitylogconfig
Update the Security Log Config with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/securitylogconfig/securitylogconfig.json",
"properties": {
"securityLoggingFeature": {
"description": "Global Parameter for Security Logging feature which should be enabled before provisioning any logging task.",
"enum" : [
"On",
"Off"
],
"default" : "Off",
"type": "string"
},
"siteIdentifier": {
"description": "Parameter to identify logging site.",
"maxLength": 20,
"minLength": 0,
"pattern": "^[a-zA-Z_0-9-]*$",
"default": "",
"type": "string"
},
"logMpDirPath": {
"description": "Directory path of MP for logging",
"maxLength": 300,
"minLength": 1,
"pattern": "^(\/[a-zA-Z_0-9-]*)+$",
"default": "/var/TKLC/db/filemgmt/securityLog/",
"type": "string"
},
"logFileTimeout": {
"description": "Timeout in seconds after which new file will be created for logging",
"maximum": 120,
"minimum": 60,
"default": 90,
"type": "integer"
},
"maxLogsPerFile": {
"description": "Maximum logs to be created per file, after which new file would be created",
"maximum": 3000000,
"minimum": 600000,
"default": 1500000,
"type": "integer"
},
"minDiskSpaceForLogging": {
"description": "Minimum available disk space in current directory filesystem to be allocated for logging",
"maximum": 100,
"minimum": 10,
"default": 30,
"type": "integer"
}
},
"required": [],
"type": "object"
}
Example
{
"logMpDirPath": "/var/TKLC/db/filemgmt/securityLog/",
"logFileTimeout": 120,
"maxLogsPerFile": 1000000,
"minDiskSpaceForLogging": 30
}
Vstp: Sfapp Options
The Sfapp Options are those configuration values that govern the overall Sfapp functionality. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new Sfapp Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT isused to update one or more values within theset of options. A name for this single, non-deletable instance is neither required nor expected.
All Sfapp Options configuration is done at the SOAM.
/vstp/sfappoptions
get /vstp/sfappoptions
Returns the set of current values for the Sfapp Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sfappoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sfappoption/sfappoption.json",
"properties": {
"agingTimer": {
"description": "This parameter defines value for aging.",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
},
"failureThreshold": {
"description": "This parameter defines the failed validation threshold",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
},
"learnTimer": {
"description": "New learning possible in this mode. No validation performed.",
"pattern":"^([4-9]|1[0-2])$|^(None)$",
"default":"8",
"type": "string"
},
"maxProfLimit": {
"description": "Maximum Profile Limit",
"enum" : [
"No",
"Yes"
],
"readOnly": true,
"default": "No",
"type": "string"
},
"maxRoamLimit": {
"description": "Maximum Roaming Limit",
"enum" : [
"No",
"Yes"
],
"readOnly": true,
"default": "No",
"type": "string"
},
"sfappMode": {
"description": "Provides the option to turn off dynamic learning,test the learning algorithm, and move the system in operation using various modes.",
"enum" : [
"Off",
"Learn",
"Test",
"Active"
],
"default": "Off",
"type": "string"
},
"successThreshold": {
"description": "This parameter defines the successful validation threshold",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
},
"velocityThreshold": {
"description": "This parameter defines the number of velocity check attempts",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
}
},
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"agingTimer": "None",
"failureThreshold": "None",
"learnTimer": "8",
"sfappMode": "Off",
"successThreshold": "None",
"velocityThreshold": "None"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/sfappoptions
Update the Sfapp Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sfappoption/sfappoption.json",
"properties": {
"agingTimer": {
"description": "This parameter defines value for aging.",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
},
"failureThreshold": {
"description": "This parameter defines the failed validation threshold",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
},
"learnTimer": {
"description": "New learning possible in this mode. No validation performed.",
"pattern":"^([4-9]|1[0-2])$|^(None)$",
"default":"8",
"type": "string"
},
"maxProfLimit": {
"description": "Maximum Profile Limit",
"enum" : [
"No",
"Yes"
],
"readOnly": true,
"default": "No",
"type": "string"
},
"maxRoamLimit": {
"description": "Maximum Roaming Limit",
"enum" : [
"No",
"Yes"
],
"readOnly": true,
"default": "No",
"type": "string"
},
"sfappMode": {
"description": "Provides the option to turn off dynamic learning,test the learning algorithm, and move the system in operation using various modes.",
"enum" : [
"Off",
"Learn",
"Test",
"Active"
],
"default": "Off",
"type": "string"
},
"successThreshold": {
"description": "This parameter defines the successful validation threshold",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
},
"velocityThreshold": {
"description": "This parameter defines the number of velocity check attempts",
"maxlength":5,
"pattern":"^()([1-9]|[1-5]?[0-9]{2,4}|6[1-4][0-9]{3}|65[1-4][0-9]{2}|655[1-2][0-9]|6553[1-5])$|^(None)$",
"type": "string"
}
},
"type": "object"
}
Example
{
"agingTimer": "None",
"failureThreshold": "None",
"learnTimer": "8",
"sfappMode": "Off",
"successThreshold": "None",
"velocityThreshold": "None"
}
Vstp: SMS Proxy Options
The SMSProxy Options are those configurable values which govern the overall of Service MP framework.There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new SMS Proxy Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected. All configurations of SMS Proxy Options is done at the SOAM.
/vstp/smsproxyoptions
get /vstp/smsproxyoptions
Returns the set of current values for the SMS Proxy Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/smsproxyoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/smsproxyoption/smsproxyoption.json",
"properties": {
"MofsmDfltActn": {
"description": "Default Action for MOFSM message validation failure.",
"enum": [
"Fallback",
"Discard",
"Udts",
"Tcaperr"
],
"default": "Discard",
"type": "string"
},
"MofsmErrCode": {
"description": "If Default action is Udts or TcapError, this error code is sent in response.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"MtfsmDfltActn": {
"description": "Default Action for MT-FSM message validation failure.",
"enum": [
"Fallback",
"Discard",
"Udts",
"Tcaperr"
],
"default": "Discard",
"type": "string"
},
"MtfsmErrCode": {
"description": "If Default action is Udts or TcapError, this error code is sent in response.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"MofsmScpval": {
"description": "Whether to perform SccpVal for MO-FSM message.",
"enum": [
"Off",
"On"
],
"default": "On",
"type": "string"
},
"MtfsmScpval": {
"description": "Whether to perform SccpVal for MT-FSM message.",
"enum": [
"Off",
"On"
],
"default": "On",
"type": "string"
},
"MtfsmInvkTimer": {
"description": "MT-FSM Timer. The MT-FSM should be received within this timer once the SRI-SM-Ack is sent to the originator.",
"maximum": 120,
"minimum": 30,
"default": 60,
"type": "integer"
},
"SmdsDosTimer": {
"description": "Initiated after MTFSM is forwarded to the VLR. The SMS Delivery Status (if required) should be received before this timer expires.",
"maximum": 120,
"minimum": 30,
"default": 60,
"type": "integer"
},
"SmsProxyGta": {
"description": "Global Title Address digits to identify the SMS Proxy Service.",
"maxLength": 15,
"minLength": 5,
"pattern": "^([a-fA-F0-9]{5,15})$",
"default": "",
"type": "string"
},
"SmsProxyTT": {
"description": "Translation type of CGPA to be used by the SMS Proxy service when generating Messages towards HLR.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"ScmblImsiPrefix": {
"description": "Prefix Digits for the Scrambled IMSI. Also defines the range of Scrambled IMSIs to be used.",
"maxLength": 10,
"minLength": 5,
"pattern": "^([a-fA-F0-9]{5,10})$",
"default": "",
"type": "string"
},
"Defcc": {
"description": "Default country code.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"Defcc": "None",
"MofsmDfltActn": "fallback",
"MofsmErrCode": 0,
"MofsmScpval": "Off",
"MtfsmDfltActn": "discard",
"MtfsmErrCode": 0,
"MtfsmInvkTimer": 60,
"MtfsmScpval": "On",
"SmdsDosTimer": 60,
"SmsProxyGta": "123456",
"SmsProxyTT": 0
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/smsproxyoptions
Update the SMS Proxy Option with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/smsproxyoption/smsproxyoption.json",
"properties": {
"MofsmDfltActn": {
"description": "Default Action for MOFSM message validation failure.",
"enum": [
"Fallback",
"Discard",
"Udts",
"Tcaperr"
],
"default": "Discard",
"type": "string"
},
"MofsmErrCode": {
"description": "If Default action is Udts or TcapError, this error code is sent in response.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"MtfsmDfltActn": {
"description": "Default Action for MT-FSM message validation failure.",
"enum": [
"Fallback",
"Discard",
"Udts",
"Tcaperr"
],
"default": "Discard",
"type": "string"
},
"MtfsmErrCode": {
"description": "If Default action is Udts or TcapError, this error code is sent in response.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"MofsmScpval": {
"description": "Whether to perform SccpVal for MO-FSM message.",
"enum": [
"Off",
"On"
],
"default": "On",
"type": "string"
},
"MtfsmScpval": {
"description": "Whether to perform SccpVal for MT-FSM message.",
"enum": [
"Off",
"On"
],
"default": "On",
"type": "string"
},
"MtfsmInvkTimer": {
"description": "MT-FSM Timer. The MT-FSM should be received within this timer once the SRI-SM-Ack is sent to the originator.",
"maximum": 120,
"minimum": 30,
"default": 60,
"type": "integer"
},
"SmdsDosTimer": {
"description": "Initiated after MTFSM is forwarded to the VLR. The SMS Delivery Status (if required) should be received before this timer expires.",
"maximum": 120,
"minimum": 30,
"default": 60,
"type": "integer"
},
"SmsProxyGta": {
"description": "Global Title Address digits to identify the SMS Proxy Service.",
"maxLength": 15,
"minLength": 5,
"pattern": "^([a-fA-F0-9]{5,15})$",
"default": "",
"type": "string"
},
"SmsProxyTT": {
"description": "Translation type of CGPA to be used by the SMS Proxy service when generating Messages towards HLR.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"ScmblImsiPrefix": {
"description": "Prefix Digits for the Scrambled IMSI. Also defines the range of Scrambled IMSIs to be used.",
"maxLength": 10,
"minLength": 5,
"pattern": "^([a-fA-F0-9]{5,10})$",
"default": "",
"type": "string"
},
"Defcc": {
"description": "Default country code.",
"maxLength": 4,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"type": "string"
}
},
"required": [],
"type": "object"
}
Example
{
"Defcc": "None",
"MofsmDfltActn": "fallback",
"MofsmErrCode": 0,
"MofsmScpval": "Off",
"MtfsmDfltActn": "discard",
"MtfsmErrCode": 0,
"MtfsmInvkTimer": 60,
"MtfsmScpval": "On",
"SmdsDosTimer": 60,
"SmsProxyGta": "123456",
"SmsProxyTT": 0
}
Vstp: MP Peer Status
Returns MP peer opertional status.
/vstp/mppeers/status
get /vstp/mppeers/status
Returns operational status for all MPs and corresponding peer MPs.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mppeerstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mppeers/mppeerstatus.json",
"properties": {
"mp": {
"description": "Name of the VSTP-MP server.",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"type": "string"
},
"peerMp": {
"description": "Name of the Peer VSTP-MP server.",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"type": "string"
},
"status": {
"description": "This indicates the operational status of the VSTP-MP server.",
"enum": [
"Available",
"Unavailable",
"Degraded",
"Unknown"
],
"type": "string"
},
"cpl": {
"description": "This is the Connection Priority Level of VSTP-MP server.",
"maximum": 99,
"minimum": 0,
"type": "integer"
},
"cplReason": {
"description": "Reason for CPL setting.",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"mp": "MP1",
"peerMp": "MP12",
"status": "Available",
"cpl": 0,
"cplReason": "Available"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
/vstp/mppeers/{mp}/status
get /vstp/mppeers/{mp}/status
Returns operational status for specified MP and corresponding peer MPs.
Target Server: SOAM
Request
URI Parameters
- mp: required (string)
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/mppeerstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/mppeers/mppeerstatus.json",
"properties": {
"mp": {
"description": "Name of the VSTP-MP server.",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"type": "string"
},
"peerMp": {
"description": "Name of the Peer VSTP-MP server.",
"pattern": "^(([A-Za-z0-9][A-Za-z0-9-]*[A-Za-z0-9])|([A-Za-z0-9]+))$",
"maxLength": 30,
"type": "string"
},
"status": {
"description": "This indicates the operational status of the VSTP-MP server.",
"enum": [
"Available",
"Unavailable",
"Degraded",
"Unknown"
],
"type": "string"
},
"cpl": {
"description": "This is the Connection Priority Level of VSTP-MP server.",
"maximum": 99,
"minimum": 0,
"type": "integer"
},
"cplReason": {
"description": "Reason for CPL setting.",
"type": "string"
}
},
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"mp": "MP1",
"peerMp": "MP12",
"status": "Available",
"cpl": 0,
"cplReason": "Available"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
Vstp: Mate Stps
A Mate Stp is an entity which holds point code entries which is used to route reponses to queries generated by the VSTP for SFAPP.
All configuration of Mate Stp is done at the SOAM.
/vstp/matestps
get /vstp/matestps
Returns all Mate Stps that meet the criteria specified in the GET request. By default, all Mate Stps configured at the SOAM are returned. If paging parameters are supplied, only those Mate Stp meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (string)
The attribute name on which filtering occurs. Non-enumerated string attributes can be filtered using EQUAL, NOT_EQUAL, LIKE or IN. Enumerated strings and integers can be filtered using EQUAL, NOT_EQUAL, and IN - LIKE is not supported for these data types.
Example:
filter_name=pointCode
- filter_op: (one of EQUAL, NOT_EQUAL, LIKE, IN)
The filter operator.
Example:
filter_op=EQUAL
- filter_values: (string)
The value being filtered on. When the filter_op is IN, filter_values can be a comma-delimited list of strings or integers. Otherwise, filter_value should be a single value.
Example:
filter_values=1-1-1
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/matestpCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/matestp/matestp.json",
"properties": {
"domain": {
"description": "This defines the type of domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"pointCode": {
"description": "The point code identifies the Mate Stp. Only one Mate Stp can have this point code .",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
}
},
"required": [
"domain",
"pointCode"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"domain": "Ansi",
"pointCode": "1-1-1"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/matestps
Adds a new Mate Stp to the VSTP configuration. The Mate Stp name must be unique across all Mate Stps at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/matestp/matestp.json",
"properties": {
"domain": {
"description": "This defines the type of domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"pointCode": {
"description": "The point code identifies the Mate Stp. Only one Mate Stp can have this point code .",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
}
},
"required": [
"domain",
"pointCode"
],
"type": "object"
}
Example
{
"domain": "Ansi",
"pointCode": "1-1-1"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/matestps/{screensetname}
get /vstp/matestps/{screensetname}
Returns the configuration details for the specified Mate Stp. If the Mate Stp does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- screensetname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/matestpItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/matestp/matestp.json",
"properties": {
"domain": {
"description": "This defines the type of domain.",
"enum": [
"Ansi",
"Itui",
"Itun",
"Itun24",
"Itui_s",
"Itun_s"
],
"type": "string"
},
"pointCode": {
"description": "The point code identifies the Mate Stp. Only one Mate Stp can have this point code .",
"maxLength": 12,
"pattern": "^([0-9]+-)*[0-9]+$",
"type": "string"
}
},
"required": [
"domain",
"pointCode"
],
"type": "object"
}
,
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"domain": "Ansi",
"pointCode": "1-1-1"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/matestps/{screensetname}
delete /vstp/matestps/{screensetname}
Deletes the specified Mate Stp from the SOAM configuration. A Mate Stp can only be deleted if all delete validation checks pass. An attempt to delete a Mate Stp that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- screensetname: required (string)
Vstp: VSTP Alarm Aggregation Options
The VSTP Alarm Aggregation Options are those configuration values that manages aggregation of vstp alarms . There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new VSTP Alarm Aggregation Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All VSTP Alarm Aggregation Options configuration is done at the SOAM.
/vstp/alarmaggregationoptions
get /vstp/alarmaggregationoptions
Returns the set of current values for the VSTP Alarm Aggregation Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/vstpalarmaggregationoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/vstpalarmaggregationoption/vstpalarmaggregationoption.json",
"properties": {
"alarmBudget": {
"description": "The total number of alarms allowed is the alarm budget. This is a fixed value. The sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"readOnly": true,
"type": "integer"
},
"associationCriticalAggAlarmThreshold": {
"description": "When the number of Connection (/vstp/connections) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) the already-raised major aggregate Connection failure alarm for that VSTP-MP is cleared, and 2) a single aggregate Connection failure alarm of critical severity is raised by the SOAM against that VSTP-MP. The value of associationCriticalAggAlarmThreshold is not included in the available alarm budget. Set associationCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for Connection failures.",
"default": 200,
"minimum": 0,
"type": "integer"
},
"associationMajorAggAlarmThreshold": {
"description": "When the number of Connection (/vstp/connections) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) all individual Connection failure alarms raised to that point are cleared, and 2) a single aggregate Connection failure alarm of major severity is raised by the SOAM against that VSTP-MP. The value of associationMajorAggAlarmThreshold is included in the available alarm budget, multiplied by the number of VSTP-MP in the DSR. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 100,
"minimum": 1,
"type": "integer"
},
"linkCriticalAggAlarmThreshold": {
"description": "When the number of Link (/vstp/links) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) the already-raised major aggregate Link failure alarm for that VSTP-MP is cleared, and 2) a single aggregate Link failure alarm of critical severity is raised by the SOAM against that VSTP-MP. The value of linkCriticalAggAlarmThreshold is not included in the available alarm budget. Set linkCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for Link failures.",
"minimum": 0,
"default": 200,
"type": "integer"
},
"linkMajorAggAlarmThreshold": {
"description": "When the number of Link (/vstp/links) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) all individual Link failure alarms raised to that point are cleared, and 2) a single aggregate Link failure alarm of major severity is raised by the SOAM against that VSTP-MP. The value of linkMajorAggAlarmThreshold is included in the available alarm budget, multiplied by the number of VSTP-MP in the DSR. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 100,
"minimum": 1,
"type": "integer"
},
"linksetCriticalAggAlarmThreshold": {
"description": "When the number of Linkset (/vstp/linksets) failure alarms raised by the VSTP exceeds this threshold: 1) all individual Linkset failure alarms raised to that point are cleared, and 2) a single aggregate Linkset failure alarm of critical severity is raised by the SOAM. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 300,
"minimum": 1,
"type": "integer"
},
"routeCriticalAggAlarmThreshold": {
"description": "When the number of Route (/vstp/routes) failure alarms raised by the VSTP exceeds this threshold: 1) all individual Route failure alarms raised to that point are cleared, and 2) a single aggregate Route failure alarm of critical severity is raised by the SOAM. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 300,
"minimum": 1,
"type": "integer"
},
"rspCriticalAggAlarmThreshold": {
"description": "When the number of Remote Signaling Point (/vstp/remotesignalingpoints) failure alarms raised by the VSTP exceeds this threshold: 1) all individual Remote Signaling Point failure alarms raised to that point are cleared, and 2) a single aggregate Remote Signaling Point failure alarm of critical severity is raised by the SOAM. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 300,
"minimum": 1,
"type": "integer"
}
},
"required": [
"associationCriticalAggAlarmThreshold",
"associationMajorAggAlarmThreshold",
"linkCriticalAggAlarmThreshold",
"linkMajorAggAlarmThreshold",
"linksetCriticalAggAlarmThreshold",
"routeCriticalAggAlarmThreshold",
"rspCriticalAggAlarmThreshold"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"associationCriticalAggAlarmThreshold": 200,
"associationMajorAggAlarmThreshold": 100,
"linkCriticalAggAlarmThreshold": 200,
"linkMajorAggAlarmThreshold": 100,
"linksetCriticalAggAlarmThreshold": 300,
"routeCriticalAggAlarmThreshold": 600,
"rspCriticalAggAlarmThreshold": 600
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/alarmaggregationoptions
Update the VSTP Alarm Aggregation Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/vstpalarmaggregationoption/vstpalarmaggregationoption.json",
"properties": {
"alarmBudget": {
"description": "The total number of alarms allowed is the alarm budget. This is a fixed value. The sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"readOnly": true,
"type": "integer"
},
"associationCriticalAggAlarmThreshold": {
"description": "When the number of Connection (/vstp/connections) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) the already-raised major aggregate Connection failure alarm for that VSTP-MP is cleared, and 2) a single aggregate Connection failure alarm of critical severity is raised by the SOAM against that VSTP-MP. The value of associationCriticalAggAlarmThreshold is not included in the available alarm budget. Set associationCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for Connection failures.",
"default": 200,
"minimum": 0,
"type": "integer"
},
"associationMajorAggAlarmThreshold": {
"description": "When the number of Connection (/vstp/connections) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) all individual Connection failure alarms raised to that point are cleared, and 2) a single aggregate Connection failure alarm of major severity is raised by the SOAM against that VSTP-MP. The value of associationMajorAggAlarmThreshold is included in the available alarm budget, multiplied by the number of VSTP-MP in the DSR. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 100,
"minimum": 1,
"type": "integer"
},
"linkCriticalAggAlarmThreshold": {
"description": "When the number of Link (/vstp/links) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) the already-raised major aggregate Link failure alarm for that VSTP-MP is cleared, and 2) a single aggregate Link failure alarm of critical severity is raised by the SOAM against that VSTP-MP. The value of linkCriticalAggAlarmThreshold is not included in the available alarm budget. Set linkCriticalAggAlarmThreshold to zero to prevent entirely the raising of a critical aggregate alarm for Link failures.",
"minimum": 0,
"default": 200,
"type": "integer"
},
"linkMajorAggAlarmThreshold": {
"description": "When the number of Link (/vstp/links) failure alarms raised by a single VSTP-MP exceeds this threshold: 1) all individual Link failure alarms raised to that point are cleared, and 2) a single aggregate Link failure alarm of major severity is raised by the SOAM against that VSTP-MP. The value of linkMajorAggAlarmThreshold is included in the available alarm budget, multiplied by the number of VSTP-MP in the DSR. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 100,
"minimum": 1,
"type": "integer"
},
"linksetCriticalAggAlarmThreshold": {
"description": "When the number of Linkset (/vstp/linksets) failure alarms raised by the VSTP exceeds this threshold: 1) all individual Linkset failure alarms raised to that point are cleared, and 2) a single aggregate Linkset failure alarm of critical severity is raised by the SOAM. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 300,
"minimum": 1,
"type": "integer"
},
"routeCriticalAggAlarmThreshold": {
"description": "When the number of Route (/vstp/routes) failure alarms raised by the VSTP exceeds this threshold: 1) all individual Route failure alarms raised to that point are cleared, and 2) a single aggregate Route failure alarm of critical severity is raised by the SOAM. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 300,
"minimum": 1,
"type": "integer"
},
"rspCriticalAggAlarmThreshold": {
"description": "When the number of Remote Signaling Point (/vstp/remotesignalingpoints) failure alarms raised by the VSTP exceeds this threshold: 1) all individual Remote Signaling Point failure alarms raised to that point are cleared, and 2) a single aggregate Remote Signaling Point failure alarm of critical severity is raised by the SOAM. So the sum of (associationMajorAggAlarmThreshold * # VSTP-MPs), (linkMajorAggAlarmThreshold * # VSTP-MPs), linksetCriticalAggAlarmThreshold, routeCriticalAggAlarmThreshold, and rspCriticalAggAlarmThreshold cannot exceed alarmBudget.",
"default": 300,
"minimum": 1,
"type": "integer"
}
},
"required": [
"associationCriticalAggAlarmThreshold",
"associationMajorAggAlarmThreshold",
"linkCriticalAggAlarmThreshold",
"linkMajorAggAlarmThreshold",
"linksetCriticalAggAlarmThreshold",
"routeCriticalAggAlarmThreshold",
"rspCriticalAggAlarmThreshold"
],
"type": "object"
}
Example
{
"associationCriticalAggAlarmThreshold": 200,
"associationMajorAggAlarmThreshold": 100,
"linkCriticalAggAlarmThreshold": 200,
"linkMajorAggAlarmThreshold": 100,
"linksetCriticalAggAlarmThreshold": 300,
"routeCriticalAggAlarmThreshold": 600,
"rspCriticalAggAlarmThreshold": 600
}
Vstp: TIF Options
The Triggerless ISUP Framework (TIF) Options are those configuration values that govern the overall TIF Framework. There is a single instance of this resource, which contains each of the individual options that can be retrieved and set. Because there is no collection of instances, there is no collection GET action. No new TIF Options resource can be created, so there is no POST action, and the single instance cannot be removed, so there is no DELETE action. The single instance GET is used to retrieve the options, and PUT is used to update one or more values within the set of options. A name for this single, non-deletable instance is neither required nor expected.
All TIF Options configuration is done at the SOAM.
/vstp/tifoptions
get /vstp/tifoptions
Returns the set of current values for the TIF Options.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/tifoptionItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/tifoption/tifoption.json",
"properties": {
"condcgpn": {
"description": "The preconditioning required when a CgPN lookup is needed.",
"enum" : [
"Addcc",
"None"
],
"default": "None",
"type": "string"
},
"crprel": {
"description": "The ISUP Release cause for a message that is determined to be circular routed.",
"maximum": 255,
"minimum": 0,
"default": 31,
"type": "integer"
},
"dfltrn": {
"description": "Default routing number. This parameter provides a set of digits to substitute for a signaling point.This parameter is used with both calling party and called party numbers.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlma": {
"description": "Delimiter A. The digits used for Delimiter A in an NPP Formatting Action.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmb": {
"description": "Delimiter B. The digits used for Delimiter B in an NPP Formatting Action.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmc": {
"description": "Delimiter C. The digits used for Delimiter C in an NPP Formatting Action.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"iamcgpn": {
"description": "The format of the outgoing CgPN digits.",
"enum" : [
"Rn",
"Rndn",
"Dn"
],
"default": "Dn",
"type": "string"
},
"matchseq": {
"description": "The DN lookup mechanism",
"enum" : [
"Dn",
"Nptype"
],
"default": "Dn",
"type": "string"
},
"npflag": {
"description": "This parameter specifies whether the nm parameter is modified in the IAM message to show that NP lookup has been performed. The nm parameter exists only in incoming and outgoing IAM messages.",
"enum" : [
"Nm",
"None"
],
"default" : "None",
"type": "string"
},
"nptypecgpn": {
"description": "NP entity type for the CgPN. The entity type of the DN that is used to indicate that a successful NP lookup occurred.",
"enum" : [
"Sp",
"Rn",
"Sprn",
"All",
"Rnspdn",
"Any"
],
"default" : "Sprn",
"type": "string"
},
"nptyperls": {
"description": "The entity type of the DN that is used to indicate that a successful NP lookup occurred for the NPRLS and NPNRLS Service Actions.",
"enum" : [
"Sp",
"Rn",
"Sprn",
"All",
"Rnspdn",
"Any"
],
"default" : "Sprn",
"type": "string"
},
"nptyperly": {
"description": "The entity type of the DN that is used to indicate that a successful NP lookup occurred for the NPRELAY Service Action.",
"enum" : [
"Sp",
"Rn",
"Sprn",
"All",
"Rnspdn",
"Any"
],
"default" : "Sprn",
"type": "string"
},
"nsaddldata": {
"description": "This parameter specifies whether the incoming IAM Calling Party Category should be compared with the value for the nspublic parameter before performing Calling Party number substitution.",
"enum" : [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"nspublic": {
"description": "The value of the Calling Party Category that indicates that the Calling Party number is public.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"rcausenp": {
"description": "The value used for the release cause in an REL message when number portability occurs.",
"maximum": 127,
"minimum": 0,
"default": 0,
"type": "integer"
},
"rcausepfx": {
"description": "The value used for the release cause in an REL message when number portability does not occur.",
"maximum": 127,
"minimum": 0,
"default": 0,
"type": "integer"
},
"rlcopc": {
"description": "This parameter specifies whether the value specified for the rcause parameter overrides the values specified for the rcausenp and rcausepfx parameters.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"rnrqd": {
"description": "This parameter specifies whether the redirection number is included in the release message when release handling is indicated.",
"enum" : [
"Yes",
"No"
],
"default": "Yes",
"type": "string"
},
"snscgpndflt": {
"description": "The digits to be used in calling number simple number substitution.",
"maxLength": 32,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"spfill": {
"description": "This parameter specifies whether the sp entity type is populated if the value specified for the defltrn or grn parameter is used for NPP processing.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"splitiam": {
"description": "This parameter specifies when to split the IAM into IAM + 1 SAM.",
"maximum": 31,
"minimum": 15,
"pattern": "^(1[5-9]|2[0-9]|3[01])$|^(None)$",
"default": "None",
"type": "string"
},
"subcdpn": {
"description": "Substitute CdPN, provides a set of digits to substitute for CdPN. Use this when SA is TIFRDNBL.",
"maxLength": 10,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"condrdn": {
"description": "The preconditioning required when redirecting number.",
"enum" : [
"Addcc",
"None"
],
"default": "None",
"type": "string"
}
},
"required": [],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"condcgpn": "None",
"crprel": 31,
"dfltrn": "None",
"dlma": "None",
"dlmb": "None",
"dlmc": "None",
"iamcgpn": "Dn",
"matchseq": "Dn",
"npflag": "None",
"nptypecgpn": "Sprn",
"nptyperls": "Sprn",
"nptyperly": "Sprn",
"nsaddldata": "No",
"nspublic": 0,
"rcausenp": 0,
"rcausepfx": 0,
"rlcopc": "Off",
"rnrqd": "Yes",
"snscgpndflt": "None",
"spfill": "Off",
"splitiam": "None"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
put /vstp/tifoptions
Update the TIF Options with the values supplied. To update just one of the individual options, GET the set, modify the value for the option that needs to be changed, then PUT the options.
Target Server: SOAM
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/tifoption/tifoption.json",
"properties": {
"condcgpn": {
"description": "The preconditioning required when a CgPN lookup is needed.",
"enum" : [
"Addcc",
"None"
],
"default": "None",
"type": "string"
},
"crprel": {
"description": "The ISUP Release cause for a message that is determined to be circular routed.",
"maximum": 255,
"minimum": 0,
"default": 31,
"type": "integer"
},
"dfltrn": {
"description": "Default routing number. This parameter provides a set of digits to substitute for a signaling point.This parameter is used with both calling party and called party numbers.",
"maxLength": 15,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlma": {
"description": "Delimiter A. The digits used for Delimiter A in an NPP Formatting Action.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmb": {
"description": "Delimiter B. The digits used for Delimiter B in an NPP Formatting Action.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"dlmc": {
"description": "Delimiter C. The digits used for Delimiter C in an NPP Formatting Action.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"iamcgpn": {
"description": "The format of the outgoing CgPN digits.",
"enum" : [
"Rn",
"Rndn",
"Dn"
],
"default": "Dn",
"type": "string"
},
"matchseq": {
"description": "The DN lookup mechanism",
"enum" : [
"Dn",
"Nptype"
],
"default": "Dn",
"type": "string"
},
"npflag": {
"description": "This parameter specifies whether the nm parameter is modified in the IAM message to show that NP lookup has been performed. The nm parameter exists only in incoming and outgoing IAM messages.",
"enum" : [
"Nm",
"None"
],
"default" : "None",
"type": "string"
},
"nptypecgpn": {
"description": "NP entity type for the CgPN. The entity type of the DN that is used to indicate that a successful NP lookup occurred.",
"enum" : [
"Sp",
"Rn",
"Sprn",
"All",
"Rnspdn",
"Any"
],
"default" : "Sprn",
"type": "string"
},
"nptyperls": {
"description": "The entity type of the DN that is used to indicate that a successful NP lookup occurred for the NPRLS and NPNRLS Service Actions.",
"enum" : [
"Sp",
"Rn",
"Sprn",
"All",
"Rnspdn",
"Any"
],
"default" : "Sprn",
"type": "string"
},
"nptyperly": {
"description": "The entity type of the DN that is used to indicate that a successful NP lookup occurred for the NPRELAY Service Action.",
"enum" : [
"Sp",
"Rn",
"Sprn",
"All",
"Rnspdn",
"Any"
],
"default" : "Sprn",
"type": "string"
},
"nsaddldata": {
"description": "This parameter specifies whether the incoming IAM Calling Party Category should be compared with the value for the nspublic parameter before performing Calling Party number substitution.",
"enum" : [
"Yes",
"No"
],
"default": "No",
"type": "string"
},
"nspublic": {
"description": "The value of the Calling Party Category that indicates that the Calling Party number is public.",
"maximum": 255,
"minimum": 0,
"default": 0,
"type": "integer"
},
"rcausenp": {
"description": "The value used for the release cause in an REL message when number portability occurs.",
"maximum": 127,
"minimum": 0,
"default": 0,
"type": "integer"
},
"rcausepfx": {
"description": "The value used for the release cause in an REL message when number portability does not occur.",
"maximum": 127,
"minimum": 0,
"default": 0,
"type": "integer"
},
"rlcopc": {
"description": "This parameter specifies whether the value specified for the rcause parameter overrides the values specified for the rcausenp and rcausepfx parameters.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"rnrqd": {
"description": "This parameter specifies whether the redirection number is included in the release message when release handling is indicated.",
"enum" : [
"Yes",
"No"
],
"default": "Yes",
"type": "string"
},
"snscgpndflt": {
"description": "The digits to be used in calling number simple number substitution.",
"maxLength": 32,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"spfill": {
"description": "This parameter specifies whether the sp entity type is populated if the value specified for the defltrn or grn parameter is used for NPP processing.",
"enum" : [
"Off",
"On"
],
"default": "Off",
"type": "string"
},
"splitiam": {
"description": "This parameter specifies when to split the IAM into IAM + 1 SAM.",
"maximum": 31,
"minimum": 15,
"pattern": "^(1[5-9]|2[0-9]|3[01])$|^(None)$",
"default": "None",
"type": "string"
},
"subcdpn": {
"description": "Substitute CdPN, provides a set of digits to substitute for CdPN. Use this when SA is TIFRDNBL.",
"maxLength": 10,
"pattern": "^([a-fA-F0-9]*)$|^(None)$",
"default": "None",
"type": "string"
},
"condrdn": {
"description": "The preconditioning required when redirecting number.",
"enum" : [
"Addcc",
"None"
],
"default": "None",
"type": "string"
}
},
"required": [],
"type": "object"
}
Example
{
"condcgpn": "None",
"crprel": 31,
"dfltrn": "None",
"dlma": "None",
"dlmb": "None",
"dlmc": "None",
"iamcgpn": "Dn",
"matchseq": "Dn",
"npflag": "None",
"nptypecgpn": "Sprn",
"nptyperls": "Sprn",
"nptyperly": "Sprn",
"nsaddldata": "No",
"nspublic": 0,
"rcausenp": 0,
"rcausepfx": 0,
"rlcopc": "Off",
"rnrqd": "Yes",
"snscgpndflt": "None",
"spfill": "Off",
"splitiam": "None"
}
Vstp: Sfapp Vlr Profile
A VLR Profile is an entity which helps in getting information about a mobile subscriber in order to locate the user while in roaming.
All configuration of Vlr Profile is done at the VSTP SOAM.
/vstp/vlrprofiles
get /vstp/vlrprofiles
Returns all Vlr Profile Data that meet the criteria specified in the GET request. By default, all records configured at the VSTP SOAM are returned. If paging parameters are supplied, only those records meeting the request parameters are returned.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sfappvlrprflItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sfappvlrprfl/sfappvlrprfl.json",
"properties": {
"filter": {
"description": "The filter determines the category in which the number falls into.",
"default": "GrayList",
"enum": [
"BlackList",
"GrayList",
"WhiteList"
],
"type": "string"
},
"failureCount":{
"description":"Failure Count",
"type":"integer"
},
"lastUsedTime": {
"description": "The date/time the status for this Link was last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"successCount":{
"description":"Ref Count",
"type":"integer"
},
"vlr": {
"description": "Number for the VSTP VLR Profile, which must be unique within the VSTP site. Valid vlr number are hexadecimal number between one and 16 characters, inclusive.",
"maxLength": 16,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
}
},
"required": [
"vlr"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"filter": "GreyList",
"lastUpdateTime":"1969-12-31T19:00:00-05:00",
"failureCount": 0,
"successCount": 0,
"vlr": "12345678910"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
Vstp: Sfapp Vlr Roaming
A VLR Roaming is an entity which is used for roaming for mobile subscribers.
All configuration of Sfapp Vlr Roaming is done at the VSTP SOAM.
/vstp/vlrroamings
get /vstp/vlrroamings
Returns all Vlr Roamings data that meet the criteria specified in the GET request. By default, all records configured at the VSTP SOAM are returned. If paging parameters are supplied, only those records meeting the request parameters are returned.
Target Server: SOAM
Response
HTTP status code 200
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/sfappvlrroamItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/sfappvlrroam/sfappvlrroam.json",
"properties": {
"newVlr": {
"description": "VLR Number to which mobile subscriber has moved.",
"type": "integer"
},
"oldVlr": {
"description": "VLR Number from which mobile subscriber has moved.",
"type": "integer"
},
"entryUsageCount":{
"description":"Entry Usage Count",
"type":"integer"
},
"lastUsedTime": {
"description": "The date/time the status for this Link was last updated by the VSTP.",
"pattern": "^[0-9]{4}[-][0-1]{1}[0-9]{1}[-][0-3]{1}[0-9]{1}T[0-2]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}[:][0-5]{1}[0-9]{1}([.][0-9]{1,7})?[+-](?:2[0-3]|[0-1][0-9])[:][0-5][0-9]?$",
"type": "string"
},
"time": {
"description": "This determines the time duration for which roaming must occur.",
"type": "integer"
},
"uniqueIdentifier": {
"description": "Defines a unique identifier for vlrroaming. The unique identifier value is a combination of oldvlrname and NewVlrName.",
"readOnly": true,
"type": "string"
}
},
"required": [
"newVlr",
"oldVlr"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"newVlrName":"657468922137",
"oldVlrName":"657468922137",
"entryUsageCount":2,
"lastUsedTimer":"1969-12-31T19:00:00-05:00",
"time":4085
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
Vstp: Whitelist VLR Profile
A VLR Profile is an entity which helps in getting information about a mobile subscriber in order to locate the user while in roaming (/vstp/vlrroamings).
All configuration of Vlr Profile is done at the SOAM.
/vstp/whitelistvlrprofiles
get /vstp/whitelistvlrprofiles
Returns all Vlr Profiles that meet the criteria specified in the GET request. By default, all Vlr Profiles configured at the SOAM are returned. If paging parameters are supplied, only those Vlr Profile meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/whitelistvlrprofileCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/whitelistvlrprofile/whitelistvlrprofile.json",
"properties": {
"filter": {
"description": "The filter determines the category in which the number falls into.",
"default": "WhiteList",
"enum": [
"WhiteList"
],
"type": "string"
},
"vlr": {
"description": "Number for the VSTP VLR Profile, which must be unique within the VSTP site.",
"maxLength": 16,
"pattern": "^(?!(0+)$)^[0-9]*$",
"type": "string"
}
},
"required": [
"vlr"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"filter": "WhiteList",
"vlr": 2
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/whitelistvlrprofiles
Adds a new Vlr Profiles to the VSTP configuration. The Vlr Profile name must be unique as it refers to the Service name at the SOAM.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/whitelistvlrprofile/whitelistvlrprofile.json",
"properties": {
"filter": {
"description": "The filter determines the category in which the number falls into.",
"default": "WhiteList",
"enum": [
"WhiteList"
],
"type": "string"
},
"vlr": {
"description": "Number for the VSTP VLR Profile, which must be unique within the VSTP site.",
"maxLength": 16,
"pattern": "^(?!(0+)$)^[0-9]*$",
"type": "string"
}
},
"required": [
"vlr"
],
"type": "object"
}
Example
{
"filter": "WhiteList",
"vlr": 2
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/whitelistvlrprofiles/{name}
get /vstp/whitelistvlrprofiles/{name}
Returns the configuration details for the specified Vlr Profile. If the Profile does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/whitelistvlrprofileItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/whitelistvlrprofile/whitelistvlrprofile.json",
"properties": {
"filter": {
"description": "The filter determines the category in which the number falls into.",
"default": "WhiteList",
"enum": [
"WhiteList"
],
"type": "string"
},
"vlr": {
"description": "Number for the VSTP VLR Profile, which must be unique within the VSTP site.",
"maxLength": 16,
"pattern": "^(?!(0+)$)^[0-9]*$",
"type": "string"
}
},
"required": [
"vlr"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"filter": "WhiteList",
"vlr": 2
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/whitelistvlrprofiles/{name}
Updates the configuration of the specified Vlr Profile. If the provided Vlr Profile data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/whitelistvlrprofile/whitelistvlrprofile.json",
"properties": {
"filter": {
"description": "The filter determines the category in which the number falls into.",
"default": "WhiteList",
"enum": [
"WhiteList"
],
"type": "string"
},
"vlr": {
"description": "Number for the VSTP VLR Profile, which must be unique within the VSTP site.",
"maxLength": 16,
"pattern": "^(?!(0+)$)^[0-9]*$",
"type": "string"
}
},
"required": [
"vlr"
],
"type": "object"
}
Example
{
"filter": "WhiteList",
"vlr": 2
}
delete /vstp/whitelistvlrprofiles/{name}
Deletes the specified Vlr Profile from the SOAM configuration. A Vlr Profile can only be deleted if all delete validation checks pass. An attempt to delete a Vlr Profile that cannot be deleted results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Vstp: Generic Name
Using Generic name, a customer can block messages with specific generic name on certain linkset.
All configuration of Generic Name is done at the SOAM.
/vstp/genericname
get /vstp/genericname
Returns all Generic Names that meet the criteria specified in the GET request. By default, all Generic Names configured at the SOAM are returned. If paging parameters are supplied, only those Generic Names meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/genericnameCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/genericname/genericname.json",
"properties": {
"gname": {
"description": "Generic Name is case insensitive, valid values are (0-9, A-Z), '*' as Wildcard and following special characters ! @ # $ ^ & ? ( ) { } [ ] ; , + : _ . \" - / ' space. Special characters when used in MMI uri(/vstp/genericname) to perform GET, PUT and DELETE operations need to be % encoded as follows %21 for !, %40 for @, %23 for #, %24 for $, %5E for ^, %26 for &, %3F for ?, %28 for (, %29 for ), %7B for {, %7D for }, %5B for [, %5D for ], %3B for ;, %2C for ,, %2B for +, %3A for :, %5F for _, %2E for ., %22 for \", %2D for -, %2A for *, %27 for ', %20 for space. GName values containing '/' must be handled using GUI only. Preceeding and succeeding spaces will be trimmed, whereas consecutive spaces in the middle of generic name are not allowed.",
"maxLength": 15,
"minLength": 1,
"pattern": "^(([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+)|([*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*]?)|([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]*)|[*])$",
"type": "string"
},
"settype": {
"description": "Generic Name Set Type",
"enum": [
"SetA",
"SetB",
"Both"
],
"type": "string"
}
},
"required": [
"gname",
"settype"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"gname": "name1",
"settype": "SetA"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/genericname
Adds a new Generic Name to the VSTP configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/genericname/genericname.json",
"properties": {
"gname": {
"description": "Generic Name is case insensitive, valid values are (0-9, A-Z), '*' as Wildcard and following special characters ! @ # $ ^ & ? ( ) { } [ ] ; , + : _ . \" - / ' space. Special characters when used in MMI uri(/vstp/genericname) to perform GET, PUT and DELETE operations need to be % encoded as follows %21 for !, %40 for @, %23 for #, %24 for $, %5E for ^, %26 for &, %3F for ?, %28 for (, %29 for ), %7B for {, %7D for }, %5B for [, %5D for ], %3B for ;, %2C for ,, %2B for +, %3A for :, %5F for _, %2E for ., %22 for \", %2D for -, %2A for *, %27 for ', %20 for space. GName values containing '/' must be handled using GUI only. Preceeding and succeeding spaces will be trimmed, whereas consecutive spaces in the middle of generic name are not allowed.",
"maxLength": 15,
"minLength": 1,
"pattern": "^(([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+)|([*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*]?)|([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]*)|[*])$",
"type": "string"
},
"settype": {
"description": "Generic Name Set Type",
"enum": [
"SetA",
"SetB",
"Both"
],
"type": "string"
}
},
"required": [
"gname",
"settype"
],
"type": "object"
}
Example
{
"gname": "name1",
"settype": "SetA"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/genericname/{gname}
get /vstp/genericname/{gname}
Returns the configuration details for the specified Generic Name. If the Generic Name does not exist in the SOAM's configuration, an error message is returned within the HTTP response. For an entry with gname "1&a", MMI command will be "mmiclient.py /vstp/genericname/1%26a".
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- gname: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/genericnameItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/genericname/genericname.json",
"properties": {
"gname": {
"description": "Generic Name is case insensitive, valid values are (0-9, A-Z), '*' as Wildcard and following special characters ! @ # $ ^ & ? ( ) { } [ ] ; , + : _ . \" - / ' space. Special characters when used in MMI uri(/vstp/genericname) to perform GET, PUT and DELETE operations need to be % encoded as follows %21 for !, %40 for @, %23 for #, %24 for $, %5E for ^, %26 for &, %3F for ?, %28 for (, %29 for ), %7B for {, %7D for }, %5B for [, %5D for ], %3B for ;, %2C for ,, %2B for +, %3A for :, %5F for _, %2E for ., %22 for \", %2D for -, %2A for *, %27 for ', %20 for space. GName values containing '/' must be handled using GUI only. Preceeding and succeeding spaces will be trimmed, whereas consecutive spaces in the middle of generic name are not allowed.",
"maxLength": 15,
"minLength": 1,
"pattern": "^(([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+)|([*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*]?)|([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]*)|[*])$",
"type": "string"
},
"settype": {
"description": "Generic Name Set Type",
"enum": [
"SetA",
"SetB",
"Both"
],
"type": "string"
}
},
"required": [
"gname",
"settype"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"gname": "name1",
"settype": "SetA"
},
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/genericname/{gname}
Updates the configuration of the specified Generic Name. If the provided Generic Name data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response. For an entry with gname ";", MMI command will be "mmiclient.py /vstp/genericname/%3B -v PUT -r gn.json" or simply "mmiclient.py /vstp/genericname -v PUT -r gn.json". Where gn.json is a json file with ";" gname value.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- gname: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/genericname/genericname.json",
"properties": {
"gname": {
"description": "Generic Name is case insensitive, valid values are (0-9, A-Z), '*' as Wildcard and following special characters ! @ # $ ^ & ? ( ) { } [ ] ; , + : _ . \" - / ' space. Special characters when used in MMI uri(/vstp/genericname) to perform GET, PUT and DELETE operations need to be % encoded as follows %21 for !, %40 for @, %23 for #, %24 for $, %5E for ^, %26 for &, %3F for ?, %28 for (, %29 for ), %7B for {, %7D for }, %5B for [, %5D for ], %3B for ;, %2C for ,, %2B for +, %3A for :, %5F for _, %2E for ., %22 for \", %2D for -, %2A for *, %27 for ', %20 for space. GName values containing '/' must be handled using GUI only. Preceeding and succeeding spaces will be trimmed, whereas consecutive spaces in the middle of generic name are not allowed.",
"maxLength": 15,
"minLength": 1,
"pattern": "^(([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+)|([*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*]?)|([A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]+[*][A-Za-z1-9.-0[-_!-$@?(){};,:' &+-]*)|[*])$",
"type": "string"
},
"settype": {
"description": "Generic Name Set Type",
"enum": [
"SetA",
"SetB",
"Both"
],
"type": "string"
}
},
"required": [
"gname",
"settype"
],
"type": "object"
}
Example
{
"gname": "name1",
"settype": "SetA"
}
delete /vstp/genericname/{gname}
Deletes the specified Generic Name from the SOAM configuration. A Generic Name can only be deleted if all delete validation checks pass. An attempt to delete a Generic Name that cannot be deleted results in an error message returned within the HTTP response. For an entry with gname "(}", MMI command will be "mmiclient.py /vstp/genericname/%28%7D".
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- gname: required (string)
Vstp: SMS Proxy SMSC Status
This table contains SMSC status i.e whether its WhiteList or BlackList All configuration of the SMS Proxy SMSC Status is done at the SOAM.
/vstp/smscstatus
get /vstp/smscstatus
Returns all SMSC Status that meet the criteria specified in the GET request. By default, all SMSC Status configured at the SOAM are returned. If paging parameters are supplied, only those SMSC Status meeting the request parameters are returned.
Target Server: SOAM
Secured by x-other
Request
Query Parameters
- filter_name: (one of configurationLevel)
The field being matched
Only the configurationLevel field is supported.
Example:
filter_name=configurationLevel
- filter_op: (one of GREATER_THAN, GREATER_THAN_EQUAL)
The match operation (operator)
Example:
filter_op=GREATER_THAN
- filter_values: (string)
The matched value
The configurationLevel value by which the data is being filtered. Only a single value is supported.
Example:
filter_values=10
- start: (integer)
The first item to return
A zero-based numerical starting point.
Example:
start=15
- count: (integer - default: 1000)
The number of items to return
A maximum of 1000 records is returned if this parameter is not provided.
Example:
count=30
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/collections/smsproxysmscstatusCollection.json",
"type": "object",
"properties": {
"data": {
"type": "array",
"items":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/smsproxysmscstatus/smsproxysmscstatus.json",
"properties": {
"smscGttAddr": {
"description": "Global Title Address of SMSCs to be allowlisted or blocklisted.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"smscStatus": {
"description": "Indicates allowlist or blocklist status of SMSC.",
"enum": [
"AllowList",
"BlockList"
],
"type": "string"
}
},
"required": [
"smscGttAddr",
"smscStatus"
],
"type": "object"
}
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data": [
{
"smscGttAddr": "2234567891",
"smscStatus": "ALLOWLIST"
}
],
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
post /vstp/smscstatus
Adds a new SMSC Status to the VSTP configuration.
Target Server: SOAM
Secured by x-other
Request
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/smsproxysmscstatus/smsproxysmscstatus.json",
"properties": {
"smscGttAddr": {
"description": "Global Title Address of SMSCs to be allowlisted or blocklisted.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"smscStatus": {
"description": "Indicates allowlist or blocklist status of SMSC.",
"enum": [
"AllowList",
"BlockList"
],
"type": "string"
}
},
"required": [
"smscGttAddr",
"smscStatus"
],
"type": "object"
}
Example
{
"smscGttAddr": "2234567891",
"smscStatus": "ALLOWLIST"
}
Response
HTTP status code 201
Request succeeded - resource created
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/items/creationItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/appworks/creation/creation.json",
"type": "string",
"description": "object identifier",
"example": "6961034c-6439-43da-b935-5238d6616f84"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
"6961034c-6439-43da-b935-5238d6616f84",
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 500
Internal server error
/vstp/smscstatus/{name}
get /vstp/smscstatus/{name}
Returns the configuration details for the specified SMSC Status. If the SMSC Status does not exist in the SOAM's configuration, an error message is returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Response
HTTP status code 200
Request succeeded
Body
Type: application/json
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/items/smsproxysmscstatusItem.json",
"type": "object",
"properties": {
"data":
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/smsproxysmscstatus/smsproxysmscstatus.json",
"properties": {
"smscGttAddr": {
"description": "Global Title Address of SMSCs to be allowlisted or blocklisted.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"smscStatus": {
"description": "Indicates allowlist or blocklist status of SMSC.",
"enum": [
"AllowList",
"BlockList"
],
"type": "string"
}
},
"required": [
"smscGttAddr",
"smscStatus"
],
"type": "object"
},
"messages":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/messages.json",
"type" :"array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"description": "A timestamp in an ISO 8601 format.",
"type": "string"
},
"severity": {
"description": "A severity code between 1 (critical) and 7 (debug)",
"type": "number",
"minimum": 1,
"maximum": 7
},
"area": {
"description": "The module producing the error",
"type": "string"
},
"message": {
"description": "The message text",
"type": "string"
},
"details": {
"description": "Additional details",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": ["timestamp", "severity", "area", "message" ]
}
},
"links":
{
"id" : "http://dsr.cgbu.oracle.com/schemas/links.json",
"type" : "object",
"additionalProperties" : {
"type" : "object",
"properties" : {
"type" : { "type": "string", "description": "The type of this link" },
"href" : { "type": "string", "description": "A link to a resource" },
"action" : { "type": "string", "description": "the http action to be used" },
"description" : { "type": "string", "description": "The purpose of this link" }
}
}
},
"status":
{ "type": "boolean" }
}
}
Example
{
"data":
{
"smscGttAddr": "2234567891",
"smscStatus": "ALLOWLIST"
}
,
"messages":
[
],
"links":
{
},
"status":
true
}
HTTP status code 400
Invalid request
HTTP status code 401
Not authenticated
HTTP status code 403
Not authorized
HTTP status code 404
Not found
put /vstp/smscstatus/{name}
Updates the configuration of the specified SMSC Status. If the provided status data is invalid in any way, the update fails, resulting in one or more error messages returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Body
Type: application/json
Schema
{
"id": "http://dsr.cgbu.oracle.com/schemas/vstp/smsproxysmscstatus/smsproxysmscstatus.json",
"properties": {
"smscGttAddr": {
"description": "Global Title Address of SMSCs to be allowlisted or blocklisted.",
"maxLength": 21,
"pattern": "^([a-fA-F0-9]*)$",
"type": "string"
},
"smscStatus": {
"description": "Indicates allowlist or blocklist status of SMSC.",
"enum": [
"AllowList",
"BlockList"
],
"type": "string"
}
},
"required": [
"smscGttAddr",
"smscStatus"
],
"type": "object"
}
Example
{
"smscGttAddr": "2234567891",
"smscStatus": "ALLOWLIST"
}
delete /vstp/smscstatus/{name}
Deletes the specified SMSC Status from the SOAM configuration. An attempt to delete a SMSC Status which does not exist results in an error message returned within the HTTP response.
Target Server: SOAM
Secured by x-other
Request
URI Parameters
- name: required (string)
Bulk Export XSD Schema
This section contains the export XSD schema that is used to validate the XML file generated by a Bulk Configurator (/bulk/configurator) GET request.
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<!-- Connection Group Object -->
<xsd:complexType name="ComagentConnectionGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="assignedServers" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Remote Servers Object -->
<xsd:complexType name="ComagentRemoteServer">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="ipAddressPreference" type="ipAddressPreferenceType"/>
<xsd:element minOccurs="1" name="localServerGroup" type="localServerGroupType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="remoteServerIPv4Address" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="remoteServerIPv6Address" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="remoteServerMode" type="remoteServerModeType"/>
</xsd:sequence>
</xsd:complexType>
<!-- END LOADGEN ATTRIBUTE DEFINITIONS -->
<xsd:complexType name="connectionGroupStat">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="priority" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ipAddressPreferenceType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="GlobalConfig"/>
<xsd:enumeration value="Ipv4"/>
<xsd:enumeration value="Ipv6"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="remoteServerModeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Client"/>
<xsd:enumeration value="Server"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="localServerGroupType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="requiredString">
<xsd:restriction base="xsd:string">
<xsd:minLength value="1"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="IPv4">
<xsd:restriction base="xsd:string">
<xsd:pattern value="(([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5])"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="IPv4orIPv6">
<xsd:restriction base="xsd:string">
<xsd:pattern value="((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))|([0-9A-Fa-f:]){1,46}|([0-9A-Fa-f]*[:]{1,2}[0-9A-Fa-f\.]*[0-9A-Fa-f]){0,46}"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="IPv4orIPv6NetMask">
<xsd:restriction base="xsd:string">
<xsd:pattern value="((([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]).){3}([01]?[0-9]?[0-9]|2[0-4][0-9]|25[0-5]))|/[0-9]{1,3}"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="yesNo">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="yes"/>
<xsd:enumeration value="no"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Peer Node Object -->
<xsd:complexType name="PeerNode">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="aaaProtocol" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="altRouteName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="altRtOnAnswerResultCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="altRtOnAnswerTimeout" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="altRtOnConnFailure" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="answerOnAnyEnabledConnection" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="appRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="avpRemovalListName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="dtlsPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="fqdn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ignorePriorityFromPeer" type="xsd:boolean"/>
<xsd:element maxOccurs="128" minOccurs="0" name="ip" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="0" name="isDynamic" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="maxAltRouteAttempts" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="minConnCapacity" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgPriorityCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgPrioritySetting" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerNodeGroupName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendingAnswerTimerName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="realm" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="replaceDestHost" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="replaceDestRealm" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingOptionSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sctpPort" type="xsd:integer"/>
<xsd:element maxOccurs="10" minOccurs="0" name="serverPort" type="Port"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tcpPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tlsPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="topologyHidingEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="transactionCfgSetName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="Port">
<xsd:restriction base="xsd:integer"></xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="IPAddress">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="yesNoType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Yes"/>
<xsd:enumeration value="No"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Local Node Object -->
<xsd:complexType name="LocalNode">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="certName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="certType" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="certVerifyMode" type="VerifyMode"/>
<xsd:element maxOccurs="1" minOccurs="1" name="cexCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="dtlsPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="endClientPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="fqdn" type="xsd:string"/>
<xsd:element maxOccurs="128" minOccurs="1" name="ip" type="LocalNodeIp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusClientPortEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="realm" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sctpPort" type="xsd:integer"/>
<xsd:element maxOccurs="10" minOccurs="0" name="serverPort" type="Port"/>
<xsd:element maxOccurs="1" minOccurs="0" name="startClientPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tcpPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tlsPort" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="LocalNodeIp">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="ipAddr" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ipType" type="localIPType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="localIPType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="LocalIp"/>
<xsd:enumeration value="IpfeTsa"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="VerifyMode">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="SslVerifyNone"/>
<xsd:enumeration value="SslVerifyPeer"/>
<xsd:enumeration value="SslVerifyPeerFailIfNoPeerCert"/>
<xsd:enumeration value="SslVerifyPeerVerifyClientOnce"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Connection Object -->
<xsd:complexType name="Connection">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="aaaProtocol" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="altLocalIp" type="ipAddressType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="altPeerIp" type="ipAddressType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="capacityCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cexCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connectionMode" type="connectionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipfeInitiatorDampIp" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="isDynamic" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="localInitiatorPort" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="localIp" type="ipAddressType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="localIpOwner" type="ipAddressType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localNodeName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgAuthCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgConvCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgPriorityCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgPrioritySetting" type="connMsgPrioritySetting"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgThrottlingCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerIdentification" type="connectionPeerIdent"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerIp" type="ipAddressType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="peerNodeName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="remoteBusyTimeout" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="remoteBusyUsage" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sharedSecretCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="statusServerCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="suppressConnAttempt" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="suppressConnUnavailableAlarm" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="testMode" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="transportCongTimeout" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="transportFqdn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="transportProtocol" type="connectionProtocol"/>
<xsd:element maxOccurs="1" minOccurs="0" name="udpPort" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ipAddressType">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="enabledDisabledType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Enabled"/>
<xsd:enumeration value="Disabled"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="connectionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="FullySpecified"/>
<xsd:enumeration value="LocalMpInitiator"/>
<xsd:enumeration value="LocalMpResponder"/>
<xsd:enumeration value="RadiusServer"/>
<xsd:enumeration value="RadiusClient"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="connectionProtocol">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Sctp"/>
<xsd:enumeration value="Dtls"/>
<xsd:enumeration value="Tcp"/>
<xsd:enumeration value="Tls"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="connectionPeerIdent">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Ip"/>
<xsd:enumeration value="TransportFqdn"/>
<xsd:enumeration value="PeerFqdn"/>
<xsd:enumeration value="None"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="connMsgPrioritySetting">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="None"/>
<xsd:enumeration value="RequestMessage"/>
<xsd:enumeration value="UserConfigured"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Peer Route Table -->
<xsd:complexType name="PeerRouteTable">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Route Group Object -->
<xsd:complexType name="RouteGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="512" minOccurs="0" name="connection" type="ConnRouteGroup"/>
<xsd:element maxOccurs="1" minOccurs="0" name="isDynamic" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="isTrafficMeasuringEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="name" type="xsd:string"/>
<xsd:element maxOccurs="160" minOccurs="0" name="peerNode" type="PeerRouteGroup"/>
<xsd:element maxOccurs="1" minOccurs="1" name="type" type="RouteGroupType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="RouteGroupType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Peer"/>
<xsd:enumeration value="Connection"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="PeerRouteGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="peerNodeName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="peerNodeWeight" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ConnRouteGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="connectionName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connectionWeight" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Connection Alarm Group -->
<xsd:complexType name="ConnectionAlarmGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="200" minOccurs="1" name="connectionName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="throttleMinorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="throttleMajorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="throttleCriticalThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementMinorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementMajorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementCriticalThreshold" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Peer Routing Rules -->
<xsd:complexType name="PeerRouteRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="action" type="peerRouteRuleAction"/>
<xsd:element maxOccurs="1" minOccurs="1" name="conditions" type="RuleConditions"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="diamAnsCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="errorMessage" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgCpyCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msgPriority" type="peerRouteRuleMsgPriority"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="priority" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routeListName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="targetPrtName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="RuleConditions">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="IntegerValueRuleCondition"/>
<xsd:element maxOccurs="1" minOccurs="1" name="cmdCode" type="StringValueRuleCondition"/>
<xsd:element maxOccurs="1" minOccurs="1" name="destHost" type="StringValueRuleCondition"/>
<xsd:element maxOccurs="1" minOccurs="1" name="destRealm" type="StringValueRuleCondition"/>
<xsd:element maxOccurs="1" minOccurs="1" name="origHost" type="StringValueRuleCondition"/>
<xsd:element maxOccurs="1" minOccurs="1" name="origRealm" type="StringValueRuleCondition"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="IntegerValueRuleCondition">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="operator" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="value" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="StringValueRuleCondition">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="operator" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="value" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="peerRouteRuleAction">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="RouteToPeer"/>
<xsd:enumeration value="SendAnswer"/>
<xsd:enumeration value="AbandonWithNoAns"/>
<xsd:enumeration value="RouteToPrt"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="peerRouteRuleMsgPriority">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Nc"/>
<xsd:enumeration value="Pr0"/>
<xsd:enumeration value="Pr1"/>
<xsd:enumeration value="Pr2"/>
<xsd:enumeration value="Pr3"/>
<xsd:enumeration value="Pr4"/>
<xsd:enumeration value="Pr5"/>
<xsd:enumeration value="Pr6"/>
<xsd:enumeration value="Pr7"/>
<xsd:enumeration value="Pr8"/>
<xsd:enumeration value="Pr9"/>
<xsd:enumeration value="Pr10"/>
<xsd:enumeration value="Pr11"/>
<xsd:enumeration value="Pr12"/>
<xsd:enumeration value="Pr13"/>
<xsd:enumeration value="Pr14"/>
<xsd:enumeration value="Pr15"/>
</xsd:restriction>
</xsd:simpleType>
<!-- DPD Realms -->
<xsd:complexType name="DpdRealm">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="realmDesc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="realmName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- DPD DNS Sets -->
<xsd:complexType name="DpdDnsSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="dnsSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="numRetries" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="primaryIp" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="queryTimeOut" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryIp" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- DPD Attribute Sets -->
<xsd:complexType name="DpdAttributeSet">
<xsd:sequence>
<xsd:element maxOccurs="10" minOccurs="1" name="applications" type="DpdAttributeApplications"/>
<xsd:element maxOccurs="1" minOccurs="1" name="capacityCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connectionMode" type="DpdConnectionMode"/>
<xsd:element maxOccurs="1" minOccurs="1" name="dnsSet" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="followProtoPref" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipfeInitiatorDAMPIp" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localIp" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localNode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="realm" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="realmPrefix" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="DpdAttributeApplications">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="addSuppVendorID" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="cexParameter" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="dtlsPreference" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxConn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxPeers" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpPreference" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpPreference" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tlsPreference" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="DpdConnectionMode">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Initiator"/>
<xsd:enumeration value="InitiatorResponder"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Traffic Throttle Point -->
<xsd:complexType name="TrafficThrottlePoint">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="altImplicitRouteListName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxEtr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxLossPercentThresh" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="peerNodeName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ttpConfigurationSetName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Traffic Throttle Group -->
<xsd:complexType name="TrafficThrottleGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="shared" type="xsd:boolean"/>
<xsd:element maxOccurs="20" minOccurs="1" name="trafficThrottlePointName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Connection Configuration Set -->
<xsd:complexType name="ConnCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="cl1MinPriorityAllowed" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cl2MinPriorityAllowed" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cl3MinPriorityAllowed" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterCexHostIpValidationEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterCexTimer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterDisconnectTimer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterPendingTransactionsPerConnection" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterProvingDeviceWatchdogRequestsToSend" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterProvingMode" type="provingMode"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterProvingTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterTransportConnectionTimer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="diameterWatchdogTimerInitValue" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusCachedResponseDuration" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusPendingTransactionsPerConnection" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusPreventDuplicateEgressRetransmission" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusPreventDuplicateIngressRetransmission" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpDatagramBundlingEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpFragmentationEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpHeartbeatInterval" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpMaximumBurst" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpMaximumSegmentSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpNumberInboundStreams" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpNumberOutboundStreams" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpOrderedDelivery" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionAssociationFailure" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionInitFailure" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionInitTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionMaximumTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionMaximumTimeoutInit" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionMinimumTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionPathFailure" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpSackDelay" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpSocketReceiveSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpSocketSendSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpKeepAliveEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpKeepAliveIdleTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpKeepAliveMaximumCount" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpKeepAliveProbeInterval" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpMaximumSegmentSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpNagleEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpSocketReceiveSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpSocketSendSize" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="provingMode">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Always"/>
<xsd:enumeration value="Suspect"/>
<xsd:enumeration value="Never"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Capacity Configuration Set -->
<xsd:complexType name="CapCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="convergenceTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ingressMpsMajorAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ingressMpsMinorAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxIngressMps" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="reservedIngressMps" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="reservedIngressMpsAbatementTime" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Egress Message Throttling Configuration Set -->
<xsd:complexType name="MsgThrottlingCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementThresh1" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="abatementThresh2" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="abatementThresh3" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="convergenceTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxEgressMessageRate" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="throttleThresh1" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="throttleThresh2" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="throttleThresh3" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Message Copy Configuration Set -->
<xsd:complexType name="MessageCopyCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="answerIncluded" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="dasAnswerResultCode" type="MCCSDasAnswerResultCodeType"/>
<xsd:element maxOccurs="4" minOccurs="1" name="maxRetryAttempts" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="originalAnswerResultCode" type="MCCSOriginalAnswerType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="requestType" type="MCCSRequestTypeType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routeListName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="MCCSDasAnswerResultCodeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="2xxx"/>
<xsd:enumeration value="Any"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="MCCSOriginalAnswerType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="2xxx"/>
<xsd:enumeration value="Any"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="MCCSRequestTypeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Ingress"/>
<xsd:enumeration value="Egress"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Rate Limiting Configuration Set -->
<xsd:complexType name="RateCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxRate" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rateAbateThresh1" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="rateAbateThresh2" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="rateAbateThresh3" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rateAbateTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rateConvergenceTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rateOnsetThresh1" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="rateOnsetThresh2" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="rateOnsetThresh3" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Pending Transaction Rate Limiting Configuration Set -->
<xsd:complexType name="PendTransCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxPendTrans" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendConvergenceTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pendTransAbateThresh1" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendTransAbateThresh2" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendTransAbateThresh3" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pendTransAbateTime" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pendTransOnsetThresh1" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendTransOnsetThresh2" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendTransOnsetThresh3" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Traffic Throttle Point Configurarion Set -->
<xsd:complexType name="TrafficThrPointCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementRecoveryRate" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defaultReductionPercentage" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="defaultValidityDuration" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="overrideMessagePriorityThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rateConvergenceTime" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Transaction Configuration Set -->
<xsd:complexType name="TransactionCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1000" minOccurs="0" name="transactionRule" type="TransactionCfgRule"/>
</xsd:sequence>
</xsd:complexType>
<!-- Transaction Configuration Rule -->
<xsd:complexType name="TransactionCfgRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="applicationRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cmdCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendingAnswerTimerName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingOptionSetName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Message Priority Configuration Set -->
<xsd:complexType name="MsgPriorityCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="50" minOccurs="1" name="messagePriorityRule" type="MessagePriorityRule"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="MessagePriorityRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="cmdCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="priority" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ruleAppliesToAllAppIds" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<!-- Capabilities Exchange Configuration Set -->
<xsd:complexType name="CexCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="10" minOccurs="0" name="clientMustIncludeAppIds" type="CexParameterCexCfgSet"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="10" minOccurs="0" name="dsrSupportedAppIds" type="CexParameterCexCfgSet"/>
<xsd:element maxOccurs="10" minOccurs="0" name="dsrSupportedVendorIds" type="DsrSupportedVendorId"/>
<xsd:element maxOccurs="1" minOccurs="1" name="includeDsrFeatureStatusAvp" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="isDynamic" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="CexParameterCexCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="appIdType" type="CexParameterAppIdType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="CexParameterAppIdType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Authentication"/>
<xsd:enumeration value="Accounting"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="DsrSupportedVendorId">
<xsd:restriction base="xsd:integer"></xsd:restriction>
</xsd:simpleType>
<!-- MCC MNC Mapping -->
<xsd:complexType name="MccMncMapping">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="ccndc" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="country" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="description" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="mcc" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="mnc" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="networkname" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="prefix" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="realm" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Egress Throttle List -->
<xsd:complexType name="Etl">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="3" minOccurs="2" name="etg" type="siteEtgNameGrp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pendingTransLimitingCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rateLimitingCfgSetName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="siteEtgNameGrp">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="connectionFailurePercentReduction" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="egressThrottleGroupName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="siteName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- MP Profile -->
<xsd:complexType name="MpProfile">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="MpProfiles" type="mpProfilesRule"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="mpProfilesRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="DAMPElements" type="attributeValueMpProfilesRule"/>
<xsd:element maxOccurs="1" minOccurs="1" name="SS7MPElements" type="attributeValueSSsevMpProfilesRule"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="attributeValueMpProfilesRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="G6_Relay" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G8G9_Relay" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G7_Relay" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G6_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G8G9_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G7_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G6_Session" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G8G9_Session" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G7_Session" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G6_Session_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G8G9_Session_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="G7_Session_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_Relay" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_10K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_6K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_8K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_12K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_14K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_16K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_18K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_21K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_24K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_27K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_30K_MPS" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="Gen9V2_Relay" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="Gen9V2_Database" type="profileValueMpProfileDamp"/>
<xsd:element maxOccurs="1" minOccurs="1" name="Gen9V2_Session" type="profileValueMpProfileDamp"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="profileValueMpProfileDamp">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="AvgHoldTimeCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="AvgHoldTimeCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="AvgHoldTimeMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="AvgHoldTimeMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="AvgHoldTimeMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="AvgHoldTimeMinorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="CL1DiscardPercent" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="CL2DiscardPercent" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="CL3DiscardPercent" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ConvergenceTime" type="mpProfileRuleConvergenceTime"/>
<xsd:element maxOccurs="1" minOccurs="1" name="DOCMsgDiscardPercent" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="DclEventTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="DrlAnswerTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="DrlMsgCopyTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="DrlRequestTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="DrlRerouteTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="FabrDpRspTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="FabrDpStatusTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="FabrReqTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="LongTimeoutPtrList" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MaxConnsThisMp" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MaxPendingTransactions" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpEngIngressMps" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpMaxIngressMps" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxAllRateCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxAllRateCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxAllRateMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxAllRateMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxAllRateMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxAllRateMinorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxDiamAllLenCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxDiamAllLenCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxDiamAllLenMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxDiamAllLenMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxDiamAllLenMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="MpRxDiamAllLenMinorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="PdraAnswerTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="PdraRequestTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="PdraSbrEventTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RbarApplTaskThr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RoutingMsgRateCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RoutingMsgRateCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RoutingMsgRateMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RoutingMsgRateMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RoutingMsgRateMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RoutingMsgRateMinorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxBatchSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxDmiwfMsgRateCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxDmiwfMsgRateCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxDmiwfMsgRateMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxDmiwfMsgRateMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxDmiwfMsgRateMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxDmiwfMsgRateMinorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrDpResponseMsgQueue" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrMsgRateCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrMsgRateCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrMsgRateMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrMsgRateMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrMsgRateMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrMsgRateMinorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxFabrRequestMsgQueue" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxRbarMsgRateCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxRbarMsgRateCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxRbarMsgRateMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxRbarMsgRateMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxRbarMsgRateMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxRbarMsgRateMinorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxRbarRequestMsgQueue" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="RxThreadPool" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="TxBatchSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="TxThreadPool" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="mpProfileRuleConvergenceTime">
<xsd:restriction base="xsd:integer">
<xsd:enumeration value="250"/>
<xsd:enumeration value="500"/>
<xsd:enumeration value="1000"/>
<xsd:enumeration value="2000"/>
<xsd:enumeration value="4000"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="attributeValueSSsevMpProfilesRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="G8G9_MDIWF" type="profileValueMpProfileSSsev"/>
<xsd:element maxOccurs="1" minOccurs="1" name="VM_MDIWF" type="profileValueMpProfileSSsev"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="profileValueMpProfileSSsev">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="RxMdIwfIngressMsgRateCriticalClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="RxMdIwfIngressMsgRateCriticalSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="RxMdIwfIngressMsgRateMajorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="RxMdIwfIngressMsgRateMajorSet" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="RxMdIwfIngressMsgRateMinorClear" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="RxMdIwfIngressMsgRateMinorSet" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- MP Profile Assignment -->
<xsd:complexType name="MpProfileAssignment">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="hostname" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="profileName" type="ProfileType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ProfileType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Unassigned"/>
<xsd:enumeration value="G6_Relay"/>
<xsd:enumeration value="G8G9_Relay"/>
<xsd:enumeration value="G7_Relay"/>
<xsd:enumeration value="G6_Database"/>
<xsd:enumeration value="G8G9_Database"/>
<xsd:enumeration value="G7_Database"/>
<xsd:enumeration value="G6_Session"/>
<xsd:enumeration value="G8G9_Session"/>
<xsd:enumeration value="G7_Session"/>
<xsd:enumeration value="G6_Session_Database"/>
<xsd:enumeration value="G8G9_Session_Database"/>
<xsd:enumeration value="G7_Session_Database"/>
<xsd:enumeration value="VM_Relay"/>
<xsd:enumeration value="VM_Database"/>
<xsd:enumeration value="VM_6K_Mps"/>
<xsd:enumeration value="VM_8K_Mps"/>
<xsd:enumeration value="VM_10K_Mps"/>
<xsd:enumeration value="VM_12K_Mps"/>
<xsd:enumeration value="VM_14K_Mps"/>
<xsd:enumeration value="VM_16K_Mps"/>
<xsd:enumeration value="VM_18K_Mps"/>
<xsd:enumeration value="VM_21K_Mps"/>
<xsd:enumeration value="VM_24K_Mps"/>
<xsd:enumeration value="VM_27K_Mps"/>
<xsd:enumeration value="VM_30K_Mps"/>
<xsd:enumeration value="G8G9_MDIWF"/>
<xsd:enumeration value="VM_MDIWF"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Route List Object -->
<xsd:complexType name="RouteList">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="isDynamic" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="minCapacity" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rarg" type="xsd:boolean"/>
<xsd:element maxOccurs="3" minOccurs="1" name="routeListRouteGroup" type="RouteListRouteGroup"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="RouteListRouteGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="priority" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routeGroupName" type="xsd:string"/>
<xsd:element maxOccurs="10" minOccurs="0" name="routeListRouteGroupTtg" type="RouteListRouteGroupTtg"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="RouteListRouteGroupTtg">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="lossPercentThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="siteName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ttgName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- IPFE Options -->
<xsd:complexType name="IpfeOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="clusterRebalancingAndAccounting" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="globalPacketRateLimit" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="gratuitousArpType" type="GratuitousArpType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="imbalanceDetectionThroughputMinimum" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipfeA1IpAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipfeA2IpAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipfeB1IpAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipfeB2IpAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="1" name="leastLoadThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="monitoringConnectionTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="monitoringConnectionTryInterval" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="monitoringPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="monitoringProtocol" type="MonitoringProtocolType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRejectOption" type="SctpRejectOptionType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="stateSyncReconnectInterval" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="stateSyncTcpPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tcpRejectOption" type="TcpRejectOptionType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="GratuitousArpType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ArpRequest"/>
<xsd:enumeration value="ArpReply"/>
<xsd:enumeration value="ArpBoth"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="MonitoringProtocolType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Heartbeat"/>
<xsd:enumeration value="None"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="SctpRejectOptionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Drop"/>
<xsd:enumeration value="IcmpAdminProhibited"/>
<xsd:enumeration value="IcmpHostUnreachable"/>
<xsd:enumeration value="IcmpPortUnreachable"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="TcpRejectOptionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Drop"/>
<xsd:enumeration value="IcmpAdminProhibited"/>
<xsd:enumeration value="IcmpHostUnreachable"/>
<xsd:enumeration value="IcmpPortUnreachable"/>
<xsd:enumeration value="TcpReset"/>
</xsd:restriction>
</xsd:simpleType>
<!-- IPFE Target Sets -->
<xsd:complexType name="IpfeTargetSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="allowedDeviation" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="alternateIpAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="0" name="alternatePreferredIpfeServer" type="PreferredIpfeServerType"/>
<xsd:element maxOccurs="16" minOccurs="1" name="applicationServerIp" type="ApplicationServerIp"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="deleteAge" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="disabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ipAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="1" name="loadBalanceAlgorithm" type="LoadBalanceAlgorithmType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="loadFactorConnectionCount" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="loadFactorMps" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="number" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerNodeAwareEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerNodeGroupDistributionThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="preferredIpfeServer" type="PreferredIpfeServerType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="protocols" type="ProtocolsType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ApplicationServerIp">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="alternateIpAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ipAddress" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverDescription" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="weight" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="LoadBalanceAlgorithmType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Hash"/>
<xsd:enumeration value="LeastLoad"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="PreferredIpfeServerType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="IpfeA1"/>
<xsd:enumeration value="IpfeA2"/>
<xsd:enumeration value="IpfeB1"/>
<xsd:enumeration value="IpfeB2"/>
<xsd:enumeration value="IpfeC1"/>
<xsd:enumeration value="IpfeC2"/>
<xsd:enumeration value="IpfeD1"/>
<xsd:enumeration value="IpfeD2"/>
<xsd:enumeration value="IpfeE1"/>
<xsd:enumeration value="IpfeE2"/>
<xsd:enumeration value="IpfeF1"/>
<xsd:enumeration value="IpfeF2"/>
<xsd:enumeration value="IpfeG1"/>
<xsd:enumeration value="IpfeG2"/>
<xsd:enumeration value="IpfeH1"/>
<xsd:enumeration value="IpfeH2"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="ProtocolsType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Sctp"/>
<xsd:enumeration value="Tcp"/>
<xsd:enumeration value="SctpAndTcp"/>
</xsd:restriction>
</xsd:simpleType>
<!-- DNS Options -->
<xsd:complexType name="DnsOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="primaryIp" type="IPAddress"/>
<xsd:element maxOccurs="1" minOccurs="1" name="queryDuration" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryIp" type="IPAddress"/>
</xsd:sequence>
</xsd:complexType>
<!-- Routing Option Sets -->
<xsd:complexType name="RoutingOptionSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connCongestionAction" type="ActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connCongestionErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connCongestionResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connCongestionVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connFailureAction" type="ActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connFailureErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connFailureResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connFailureVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="destRealmNotServedAction" type="ActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="destRealmNotServedErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="destRealmNotServedResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="destRealmNotServedVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maxPerMsgFwdAllowed" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nestedArtPrtErrorAction" type="ActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nestedArtPrtErrorErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nestedArtPrtErrorResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nestedArtPrtErrorVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="noPeerResponseAction" type="ActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="noPeerResponseErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="noPeerResponseResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="noPeerResponseVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="peerRptCongestionAction" type="ActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerRptCongestionErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerRptCongestionResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="peerRptCongestionVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pendingAnswerTimerName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="resExhAction" type="ActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="transactionLifetime" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="ActionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Abandon"/>
<xsd:enumeration value="SendAnswer"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Options -->
<xsd:complexType name="Option">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="alarmBudget" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="alarmGroupFeatureEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="congestionDiscardPolicy" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connCriticalAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connMajorAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connReservedIngressMpsScaling" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="diameterEngMessageSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="dpdRealmExpiryMajAlarmThresholdHrs" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="dpdRealmExpiryMinAlarmThresholdHrs" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="encodeFqdnInLowerCase" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="etgMode" type="etgModeType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="excessiveRerouteAbateThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="excessiveRerouteOnsetThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ipfeConnCriticalAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ipfeConnMajorAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mccsForRfMsgCopy" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="msgCopyDisableCongLevel" type="congLevelType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="msgCopyFeatureEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPs16PriorityAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ngnPsAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsAnswerPriorityMode" type="answerPriorityModeType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsCxAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsDhAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsGxAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsGxAdvancedPriority" type="gxAdvancedPriorityType"/>
<xsd:element maxOccurs="5" minOccurs="0" name="ngnPsGxArp" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ngnPsMaxMessageRatePercentage" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsMaxNormalRequestPriority" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsMaxPriority0Allowed" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsMaxPriority1Allowed" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsMaxPriority2Allowed" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsMinimumAnswerPriority" type="answerPriorityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsMinimumInviolablePriority" type="inviolablePriorityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsRxAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsRxMpsAvpValue" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="peerNodeCriticalAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="peerPingFeatureEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="radiusAAARouteList" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="radiusMPNRouteList" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="radiusUMFRouteList" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusUdpClientSockRecvSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusUdpClientSockSendSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusUdpServerSockRecvSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusUdpServerSockSendSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="redirectAnsProcessingEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="redirectApplicationRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="redirectPeerRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rfMsgCopyFeatureEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routeListCriticalAggAlarmThreshold" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Application Priority Option -->
<xsd:complexType name="ApplicationPriorityOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="answerDrmpAvpAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPs3gppAvpAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ngnPsDrmpAvpAdminStateEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="requestDrmpAvpAdminStateEnabled" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="congLevelType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Cl1"/>
<xsd:enumeration value="Cl2"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="gxAdvancedPriorityType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Hss"/>
<xsd:enumeration value="None"/>
<xsd:enumeration value="Spr"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="answerPriorityType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="P0"/>
<xsd:enumeration value="P3"/>
<xsd:enumeration value="P14"/>
<xsd:enumeration value="P15"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="inviolablePriorityType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="P3"/>
<xsd:enumeration value="P4"/>
<xsd:enumeration value="P15"/>
<xsd:enumeration value="P99"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="etgModeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Threshold"/>
<xsd:enumeration value="Limit"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="answerPriorityModeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="HighestPriority"/>
<xsd:enumeration value="RequestPriority"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Application Ids -->
<xsd:complexType name="ApplicationId">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Application Route Table -->
<xsd:complexType name="ApplicationRouteTable">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Peer Node Alarm Group -->
<xsd:complexType name="PeerNodeAlarmGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="200" minOccurs="1" name="peerNodeName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="throttleMinorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="throttleMajorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="throttleCriticalThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementMinorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementMajorThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="abatementCriticalThreshold" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Peer Node Group -->
<xsd:complexType name="PeerNodeGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="32" minOccurs="0" name="peerNode" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Pending Answer Timer -->
<xsd:complexType name="PendingAnswerTimer">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="value" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Command Code -->
<xsd:complexType name="CommandCode">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="cmdCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="appIdType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Accounting"/>
<xsd:enumeration value="Authentication"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Reserved MCC Range -->
<xsd:complexType name="ReservedMccRange">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="endMccRange" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="startMccRange" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- AVP Removal List -->
<xsd:complexType name="AvpRemovalList">
<xsd:sequence>
<xsd:element maxOccurs="10" minOccurs="1" name="avp" type="AvpRemovalListType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="direction" type="RemovalDirectionType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="messageType" type="RemovalType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="AvpRemovalListType">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="avpCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="avpName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="vendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="RemovalDirectionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Egress"/>
<xsd:enumeration value="Ingress"/>
<xsd:enumeration value="IngressAndEgress"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="RemovalType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="AnswerOnly"/>
<xsd:enumeration value="RequestOnly"/>
<xsd:enumeration value="RequestAndAnswer"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Reroute On Answer -->
<xsd:complexType name="RerouteOnAnswer">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="ansResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="id" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ruleAppliesToAllAppIds" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<!-- Application Route Rule -->
<xsd:complexType name="ApplicationRouteRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="action" type="appRouteRuleAction"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ansErrorMessage" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ansResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="appName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="appRouteTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="conditions" type="RuleConditions"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="forwardToTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="gxPrimeRequest" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="priority" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="appRouteRuleAction">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="AbandonWithNoAns"/>
<xsd:enumeration value="ForwardToEgressRouting"/>
<xsd:enumeration value="RouteToAppl"/>
<xsd:enumeration value="SendAnswer"/>
<xsd:enumeration value="ForwardToArt"/>
<xsd:enumeration value="ForwardToPrt"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Egress Throttle Group -->
<xsd:complexType name="EgressThrottleGroup">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="128" minOccurs="0" name="connectionName" type="xsd:string"/>
<xsd:element minOccurs="1" name="etgControlScope" type="etgControlScopeType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="128" minOccurs="0" name="peerNodeName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pendingTransLimitingCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rateLimitingCfgSetName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="etgControlScopeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Etg"/>
<xsd:enumeration value="Etl"/>
</xsd:restriction>
</xsd:simpleType>
<!-- CEX Parameter -->
<xsd:complexType name="CexParameter">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="appId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="appIdType" type="CexParameterAppIdType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="id" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Topology Hiding: Trusted Network Lists -->
<xsd:complexType name="TrustedNetworkList">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="100" minOccurs="1" name="trustedRealm" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Topology Hiding: Path Topology Hiding Configuration Sets -->
<xsd:complexType name="PathTopologyHidingCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="encryptionKey" type="xsd:string"/>
<xsd:element maxOccurs="10" minOccurs="1" name="hostnameSuffix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pseudoProxy" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pseudoRouteRecord" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Topology Hiding: Hss Topology Hiding Configuration Sets -->
<xsd:complexType name="HssTopologyHidingCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="action" type="topologyHidingAction"/>
<xsd:element maxOccurs="1" minOccurs="0" name="autoGenerate" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="count" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="errMsg" type="xsd:string"/>
<xsd:element maxOccurs="300" minOccurs="0" name="hostnames" type="hostName"/>
<xsd:element maxOccurs="1" minOccurs="0" name="length" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="prefix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="randomizeCount" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="singlePseudoHosts" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="suffix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="useSinglePseudoHost" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Topology Hiding: Mme Topology Hiding Configuration Sets -->
<xsd:complexType name="MmeTopologyHidingCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="action" type="topologyHidingAction"/>
<xsd:element maxOccurs="1" minOccurs="0" name="autoGenerate" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="count" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="errMsg" type="xsd:string"/>
<xsd:element maxOccurs="300" minOccurs="1" name="hostnames" type="hostName"/>
<xsd:element maxOccurs="1" minOccurs="0" name="length" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="prefix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="randomizeCount" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="suffix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Topology Hiding: Pcrf Topology Hiding Configuration Sets -->
<xsd:complexType name="PcrfTopologyHidingCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="action" type="topologyHidingAction"/>
<xsd:element maxOccurs="1" minOccurs="0" name="autoGenerate" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="count" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="errMsg" type="xsd:string"/>
<xsd:element maxOccurs="600" minOccurs="1" name="hostnames" type="hostName"/>
<xsd:element maxOccurs="1" minOccurs="0" name="length" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="prefix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="randomizeCount" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="suffix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Topology Hiding: Af Topology Hiding Configuration Sets -->
<xsd:complexType name="AfTopologyHidingCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="action" type="topologyHidingAction"/>
<xsd:element maxOccurs="1" minOccurs="0" name="autoGenerate" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="count" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="errMsg" type="xsd:string"/>
<xsd:element maxOccurs="1200" minOccurs="1" name="hostnames" type="hostName"/>
<xsd:element maxOccurs="1" minOccurs="0" name="length" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="prefix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="randomizeCount" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="suffix" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="topologyHidingAction">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="SendAnswer"/>
<xsd:enumeration value="Abandon"/>
<xsd:enumeration value="Forward"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="hostName">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="actualHostname" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pseudoHostname1" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pseudoHostname2" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pseudoHostname3" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Topology Hiding: Protected Networks -->
<xsd:complexType name="ProtectedNetwork">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="afTopologyHidingCfgSet" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="hssTopologyHidingCfgSet" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mmeTopologyHidingCfgSet" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pathTopologyHidingCfgSet" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pcrfTopologyHidingCfgSet" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="protectedRealm" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="trustedNetList" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rf Message Copy -->
<xsd:complexType name="RfMessageCopy">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="apn" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- FABR Address Resolution Object -->
<xsd:complexType name="AddressResolution">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="applId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="applIdCmdCodeId" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="cmdCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="primaryRoutingEntity" type="routingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="primaryRoutingEntityBlacklistSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="primaryRoutingEntityDestinationType" type="resolutionDestinationType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="primaryRoutingEntityFallBackSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="primaryRoutingEntityPrefixSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="primaryRoutingEntityPrimaryAvp" type="AVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="primaryRoutingEntitySecondaryAvp" type="secondaryAvp"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntity" type="routingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntityBlacklistSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntityDestinationType" type="AVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntityFallBackSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntityPrefixSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntityPrimaryAvp" type="AVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntitySecondaryAvp" type="secondaryAvp"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntity" type="routingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntityBlacklistSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntityDestinationType" type="resolutionDestinationType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntityFallBackSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntityPrefixSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntityPrimaryAvp" type="AVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntitySecondaryAvp" type="secondaryAvp"/>
</xsd:sequence>
</xsd:complexType>
<!-- FABR Default Destination Object -->
<xsd:complexType name="DefaultDestination">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="fqdn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="realm" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- FABR System Options -->
<xsd:complexType name="FabrOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="allowSubsequentDSRAppInvoc" type="xsd:boolean"/>
<xsd:element maxOccurs="10" minOccurs="0" name="asciiExcludedList" type="asciiDigit"/>
<xsd:element maxOccurs="1" minOccurs="1" name="blacklistSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="bundlingEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="excludeSpace" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="fallbackSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="fqdn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="maximumBundleSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="prefixSearchEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="realm" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="removeDestHost" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhaustionErrCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhaustionErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhaustionVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="5" minOccurs="0" name="tbcdExcludedList" type="tbcdExcluded"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppAction" type="unvApplication"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppRouteList" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppVendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="asciiDigit">
<xsd:restriction base="xsd:string"/>
</xsd:simpleType>
<!-- FABR Routing Exception Object -->
<xsd:complexType name="RoutingException">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="action" type="exceptionAction"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ansResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="applId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="destName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="errMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="exceptionType" type="routingExceptionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- FABR Supported Application Object -->
<xsd:complexType name="SupportedApplication">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="applId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingMode" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- END LOADGEN ATTRIBUTE DEFINITIONS -->
<xsd:simpleType name="routingEntityType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Imsi"/>
<xsd:enumeration value="Impi"/>
<xsd:enumeration value="Impu"/>
<xsd:enumeration value="Msisdn"/>
<xsd:enumeration value="ExternalId"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="resolutionDestinationType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Aaa"/>
<xsd:enumeration value="Ocs"/>
<xsd:enumeration value="Ofcs"/>
<xsd:enumeration value="Pcrf"/>
<xsd:enumeration value="ImsHss"/>
<xsd:enumeration value="LteHss"/>
<xsd:enumeration value="MtcHss"/>
<xsd:enumeration value="UserDefined1"/>
<xsd:enumeration value="UserDefined2"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="AVP">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Msisdn"/>
<xsd:enumeration value="UserName"/>
<xsd:enumeration value="PublicIdentity"/>
<xsd:enumeration value="SubscriptionId0"/>
<xsd:enumeration value="SubscriptionId1"/>
<xsd:enumeration value="SubscriptionId2"/>
<xsd:enumeration value="SubscriptionId3"/>
<xsd:enumeration value="SubscriptionId4"/>
<xsd:enumeration value="SvcInfoSubscrId0"/>
<xsd:enumeration value="SvcInfoSubscrId1"/>
<xsd:enumeration value="SvcInfoSubscrId2"/>
<xsd:enumeration value="SvcInfoSubscrId3"/>
<xsd:enumeration value="SvcInfoSubscrId4"/>
<xsd:enumeration value="UserIdentityMsisdn"/>
<xsd:enumeration value="UserIdentityPublic"/>
<xsd:enumeration value="UserIdentifierMsisdn"/>
<xsd:enumeration value="UserIdentifierUserName"/>
<xsd:enumeration value="DeviceActionExternalId"/>
<xsd:enumeration value="UserIdentifierExternalId"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="secondaryAvp">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Msisdn"/>
<xsd:enumeration value="UserName"/>
<xsd:enumeration value="PublicIdentity"/>
<xsd:enumeration value="SubscriptionId0"/>
<xsd:enumeration value="SubscriptionId1"/>
<xsd:enumeration value="SubscriptionId2"/>
<xsd:enumeration value="SubscriptionId3"/>
<xsd:enumeration value="SubscriptionId4"/>
<xsd:enumeration value="SvcInfoSubscrId0"/>
<xsd:enumeration value="SvcInfoSubscrId1"/>
<xsd:enumeration value="SvcInfoSubscrId2"/>
<xsd:enumeration value="SvcInfoSubscrId3"/>
<xsd:enumeration value="SvcInfoSubscrId4"/>
<xsd:enumeration value="UserIdentityMsisdn"/>
<xsd:enumeration value="UserIdentityPublic"/>
<xsd:enumeration value="UserIdentifierMsisdn"/>
<xsd:enumeration value="UserIdentifierUserName"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="unvApplication">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ContinueRouting"/>
<xsd:enumeration value="DefaultRoute"/>
<xsd:enumeration value="SendAnswer"/>
<xsd:enumeration value="SendAnsExp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="tbcdExcluded">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="*"/>
<xsd:enumeration value="#"/>
<xsd:enumeration value="a"/>
<xsd:enumeration value="b"/>
<xsd:enumeration value="c"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="routingExceptionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="DpErrors"/>
<xsd:enumeration value="NoAddrMatch"/>
<xsd:enumeration value="DpCongestion"/>
<xsd:enumeration value="UnknownCmdCode"/>
<xsd:enumeration value="BlacklistedSubscriber"/>
<xsd:enumeration value="NoRoutingEntityAddress"/>
<xsd:enumeration value="NoDrtEntry"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="exceptionAction">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="AbandonRequest"/>
<xsd:enumeration value="FwdUnchanged"/>
<xsd:enumeration value="FwdToDest"/>
<xsd:enumeration value="SendAnswer"/>
<xsd:enumeration value="SendAnsExp"/>
</xsd:restriction>
</xsd:simpleType>
<!-- RADIUS Ingress Status Server Configuration Set Object -->
<xsd:complexType name="IngressStatusServerConfigurationSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="ingressStatusServerSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sendResponseToStatusServer" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="statusServerResponseMessageType" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- RADIUS Message Authenticator Configuration Set Object -->
<xsd:complexType name="MessageAuthenticatorConfigurationSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="clientEncodeMessageAuthenticatorInEgressAccessRequest" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="clientEncodeMessageAuthenticatorInEgressCoARequest" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="clientEncodeMessageAuthenticatorInEgressDisconnectRequest" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="messageAuthenticatorConfigurationSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressAccessAccept" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressAccessChallenge" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressAccessReject" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressCoAACK" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressCoANACK" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressDisconnectACK" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressDisconnectNACK" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverEncodeMessageAuthenticatorInEgressStatusServer" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<!-- RADIUS Message Conversion Configuration Set Object -->
<xsd:complexType name="MessageConversionConfigurationSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="msgConvCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="10" minOccurs="1" name="msgConvCfgSetRules" type="CfgSetRules"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="CfgSetRules">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="applId" type="xsd:string"/>
<xsd:element maxOccurs="5" minOccurs="0" name="applName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="cmdCodes" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="convType" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="radiusCode" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- RADIUS NAS Node Object -->
<xsd:complexType name="NasNode">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="fqdn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nasIdentifier" type="xsd:string"/>
<xsd:element maxOccurs="4" minOccurs="0" name="nasIPAddresses" type="NASIPAddress"/>
<xsd:element maxOccurs="1" minOccurs="1" name="nasNodeName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="realm" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="NASIPAddress">
<xsd:restriction base="xsd:string"></xsd:restriction>
</xsd:simpleType>
<!-- RADIUS Network Option Object -->
<xsd:complexType name="NetworkOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="networkScopedSharedSecret" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- RADIUS Routing Table Object -->
<xsd:complexType name="RadiusRoutingTable">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="apn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="authMpn" type="yesNoOption"/>
<xsd:element maxOccurs="1" minOccurs="1" name="keyAvp" type="KeyAvp"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vrfId" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="yesNoOption">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Yes"/>
<xsd:enumeration value="No"/>
</xsd:restriction>
</xsd:simpleType>
<!-- RADIUS Shared Secret Configuration Set Object -->
<xsd:complexType name="SharedSecretConfigurationSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sharedSecret" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- END LOADGEN ATTRIBUTE DEFINITIONS -->
<xsd:simpleType name="KeyAvp">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Apn"/>
<xsd:enumeration value="VrfId"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Rbar Address Range Object -->
<xsd:complexType name="RbarAddressRange">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="destination" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="endAddr" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="id" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipv6PfxLength" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nestedTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routingEntity" type="rbarRoutingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingEntityComp" type="routingEntityCompType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="startAddr" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tableName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rbar Address Resolution Object -->
<xsd:complexType name="RbarAddressResolution">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="applId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="cmdCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="id" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="primaryRoutingEntity" type="rbarRoutingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="primaryRoutingEntityAddrTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="primaryRoutingEntityPrimaryAvp" type="rbarAVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="primaryRoutingEntitySecondaryAvp" type="rbarAVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntity" type="rbarRoutingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntityAddrTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntityPrimaryAvp" type="rbarAVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="secondaryRoutingEntitySecondaryAvp" type="rbarAVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntity" type="rbarRoutingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntityAddrTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntityPrimaryAvp" type="AVP"/>
<xsd:element maxOccurs="1" minOccurs="0" name="tertiaryRoutingEntitySecondaryAvp" type="AVP"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rbar Address Table Object -->
<xsd:complexType name="RbarAddressTable">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="comment" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routingEntity" type="rbarRoutingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingEntityComp" type="routingEntityCompType"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rbar Destination Object -->
<xsd:complexType name="RbarDestination">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="avpInsertion" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="fqdn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="realm" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rbar Domain Address Object -->
<xsd:complexType name="RbarDomainAddress">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="address" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="destination" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="id" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipv6PfxLength" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nestedTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routingEntity" type="rbarRoutingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingEntityComp" type="routingEntityCompType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tableName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rbar Individual Address Object -->
<xsd:complexType name="RbarIndividualAddress">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="address" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="destination" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="id" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ipv6PfxLength" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nestedTableName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routingEntity" type="rbarRoutingEntityType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingEntityComp" type="routingEntityCompType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tableName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rbar Options Definition -->
<xsd:complexType name="RbarOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="allowSubsequentDSRAppInvoc" type="xsd:boolean"/>
<xsd:element maxOccurs="10" minOccurs="0" name="asciiExcludedList" type="rbarAsciiDigit"/>
<xsd:element maxOccurs="1" minOccurs="0" name="excludeSpace" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="fqdn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="realm" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="removeDestHost" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="resExhaustionErrCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhaustionErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="resExhaustionVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="5" minOccurs="0" name="tbcdExcludedList" type="tbcdExcludedRbar"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppAction" type="unvApplicationRbar"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppErrMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppRouteList" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unavailableAppVendorId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="uriSupported" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="rbarAsciiDigit">
<xsd:restriction base="xsd:string"/>
</xsd:simpleType>
<!-- Rbar Routing Exception Definition -->
<xsd:complexType name="RbarRoutingException">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="action" type="exceptionActionRbar"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ansResultCode" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="applId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="destName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="errMsg" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="exceptionType" type="rbarRoutingExceptionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="id" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vendorId" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Rbar Supported Applications Definition -->
<xsd:complexType name="RbarSupportedApplication">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="applId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingMode" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- END LOADGEN ATTRIBUTE DEFINITIONS -->
<xsd:simpleType name="rbarRoutingEntityType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Imsi"/>
<xsd:enumeration value="Msisdn"/>
<xsd:enumeration value="Impi"/>
<xsd:enumeration value="Impu"/>
<xsd:enumeration value="Ipv4"/>
<xsd:enumeration value="Ipv6PfxAddr"/>
<xsd:enumeration value="Unsigned16"/>
<xsd:enumeration value="ExternalId"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="routingEntityCompType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="LocalIdentifier"/>
<xsd:enumeration value="DomainIdentifier"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="rbarAVP">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="PublicIdentity"/>
<xsd:enumeration value="SvcInfoSubscrId0"/>
<xsd:enumeration value="SvcInfoSubscrId1"/>
<xsd:enumeration value="SvcInfoSubscrId2"/>
<xsd:enumeration value="SvcInfoSubscrId3"/>
<xsd:enumeration value="SvcInfoSubscrId4"/>
<xsd:enumeration value="SubscriptionId0"/>
<xsd:enumeration value="SubscriptionId1"/>
<xsd:enumeration value="SubscriptionId2"/>
<xsd:enumeration value="SubscriptionId3"/>
<xsd:enumeration value="SubscriptionId4"/>
<xsd:enumeration value="UserIdentityMsisdn"/>
<xsd:enumeration value="UserIdentityPublic"/>
<xsd:enumeration value="UserName"/>
<xsd:enumeration value="FramedIpAddress"/>
<xsd:enumeration value="FramedIpv6Prefix"/>
<xsd:enumeration value="SvcInfoPsInfo3gppcc"/>
<xsd:enumeration value="Msisdn"/>
<xsd:enumeration value="UserIdentifierMsisdn"/>
<xsd:enumeration value="UserIdentifierUserName"/>
<xsd:enumeration value="UserIdentifierExternalId"/>
<xsd:enumeration value="DeviceActionExternalId"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="unvApplicationRbar">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ContinueRouting"/>
<xsd:enumeration value="DefaultRoute"/>
<xsd:enumeration value="SendAnswer"/>
<xsd:enumeration value="SendAnsExp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="tbcdExcludedRbar">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="*"/>
<xsd:enumeration value="#"/>
<xsd:enumeration value="a"/>
<xsd:enumeration value="b"/>
<xsd:enumeration value="c"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="rbarRoutingExceptionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="UnknownCmdCode"/>
<xsd:enumeration value="NoRoutingEntityAddress"/>
<xsd:enumeration value="NoDrtEntry"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="exceptionActionRbar">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="AbandonRequest"/>
<xsd:enumeration value="FwdUnchanged"/>
<xsd:enumeration value="FwdToDest"/>
<xsd:enumeration value="SendAnswer"/>
<xsd:enumeration value="SendAnsExp"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Database Options Object -->
<xsd:complexType name="DatabaseOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="auditOperationRate" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- Database Resizing Plans Object -->
<xsd:complexType name="DatabaseResizingPlan">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="databaseType" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="initialNumOfServerGroups" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="initialResourceDomainName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="planName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sbrDatabaseName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="targetNumOfServerGroups" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="targetResourceDomainName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- Sbr Databases Object -->
<xsd:complexType name="SbrDatabase">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="databaseType" type="sbrDatabaseType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="numberOfServerGroups" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ownerAppName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="placeAssociationName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="resourceDomainName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sbrDatabaseName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="sbrDatabaseType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Binding"/>
<xsd:enumeration value="Session"/>
<xsd:enumeration value="Usbr"/>
</xsd:restriction>
</xsd:simpleType>
<!-- Data Migration Plans Object -->
<xsd:complexType name="DataMigrationPlan">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="initDatabase" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="initPlaceAssociation" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="migrationType" type="MigrationPlanType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="planName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="targetDatabase" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="targetPlaceAssociation" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="MigrationPlanType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Mating"/>
<xsd:enumeration value="ReMating"/>
<xsd:enumeration value="UnMating"/>
</xsd:restriction>
</xsd:simpleType>
<!-- VSTP Connection Object -->
<xsd:complexType name="VstpConnection">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connCfgSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="connectionMode" type="connectionModeType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connectionType" type="connType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localHostName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="remoteHostName" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Connection Configuration Set Object -->
<xsd:complexType name="VstpConnCfgSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpFragmentationEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sctpHeartbeatInterval" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpMaximumBurst" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpMaximumSegmentSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpNumberInboundStreams" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpNumberOutboundStreams" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpOrderedDelivery" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionAssociationFailure" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionInitFailure" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionInitTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionMaximumTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionMaximumTimeoutInit" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionMinimumTimeout" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpRetransmissionPathFailure" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpSackDelay" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpSocketReceiveSize" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sctpSocketSendSize" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Default Conversion Object -->
<xsd:complexType name="VstpDefaultConversion">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="dir" type="dirType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="gtixlat" type="gtixlatType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nai" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="np" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="npdd" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="npds" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nsdd" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nsds" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tta" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tti" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Feature Admin State Object -->
<xsd:complexType name="VstpFeatureAdminState">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="adminState" type="adminStateType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Gtt Action Object -->
<xsd:complexType name="VstpGttAction">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="act" type="actType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="actid" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atcaperr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cdGtmodName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgGtmodName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgpc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgpcogmsg" type="cgpcogmsgType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defactid" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="domain" type="domainType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="itcaperr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="loopSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mapSetId" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mrnSetId" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ri" type="riType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="rspName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ssn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="udtserr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="uimreqd" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="useicmsg" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Gtt Title Address Object -->
<xsd:complexType name="VstpGttTitleAddress">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="acn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="actsn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccgt" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cdselid" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cdssn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgGtmod" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgcnvsn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgpc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgpcaction" type="cgpcactionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgselid" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgssn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defmapvr" type="defmapvrType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="domain" type="domainType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ecdssn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ecgssn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="emapaddr" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="endAddress" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="fallback" type="fallbackType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="family" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gtmodName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="gttSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="loopSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="lspName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mapSetId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mrnSetId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="opc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="opcode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="opcsn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="optsn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pkgtype" type="pkgType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingIndicator" type="riType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="rspName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="smapaddr" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="splitAction" type="splitActionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="startAddress" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="subsystem" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="translateIndicator" type="translateIndicatorType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="uniqueIdentifier" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Gtt Modifications Object -->
<xsd:complexType name="VstpGttMod">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="cgpaSsn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gtZeroFill" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gtmodId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="newGTI" type="newGTIType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="newNAI" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="newNP" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="newTT" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="npdd" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="npds" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nsdd" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nsds" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sfxFirst" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Gtt Selector Object -->
<xsd:complexType name="VstpGttSelector">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="cdgttsn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cggttsn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgssn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="domain" type="domainType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="globalTitleIndicator" type="globalTitleIndicatorType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gttSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="linksetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="natureOfAddressIndicator" type="natureOfAddressIndicatorType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="natureOfAddressIndicatorValue" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="numberingPlan" type="numberingPlanType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="numberingPlanValue" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="selid" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="translationType" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Gtt Set Object -->
<xsd:complexType name="VstpGttSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="domain" type="domType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gttSetType" type="gttSETType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="npsn" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Gtt Action Set Object -->
<xsd:complexType name="VstpGttActionSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="actid1" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="actid2" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="actsn" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Home Entity Object -->
<xsd:complexType name="VstpHomeEntity">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="entityAddress" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="entityType" type="entType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpDelPfx" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Link Object -->
<xsd:complexType name="VstpLink">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="connectionName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="linksetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="signalingLinkCode" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Link Set Object -->
<xsd:complexType name="VstpLinkSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="asNotification" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cgGtmod" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="enableBroadcastException" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gttmode" type="gttmodeType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ituTransferRestricted" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="linkTransactionsPerSecond" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localSignalingPointName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtpScrEventLog" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtpScrSetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtpScrTestMode" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="numberSignalingLinkAllowedThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="numberSignalingLinkProhibitedThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="remoteSignalingPointName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="routingContext" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="type" type="connType"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Local Host Object -->
<xsd:complexType name="VstpLocalHost">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localHostName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localHostPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="localHostPriIPAddress" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="localHostSecIPAddress" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Local Signaling Point Object -->
<xsd:complexType name="VstpLocalSignalingPoint">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cpcType" type="cpcsType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="mtpPointCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="pcType" type="pcsType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ss7DomainType" type="domainType"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP M2pa Option Object -->
<xsd:complexType name="VstpM2paOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="t16Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t17Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t1Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t2Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t3Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t4EmergencyTimer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t4NormalTimer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t5Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t6Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t7Timer" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP M3rl Option Object -->
<xsd:complexType name="VstpM3rlOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="cnvAInat" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cnvCgda" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cnvCgdi" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cnvCgdn" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cnvCgdn24" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cnvClgItu" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="gtCnvDflt" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="lsOnHoldTimer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="slsRotation" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sltT1Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sltT2Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="sparePCSupportEnabled" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t10Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t11Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t15Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t16Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t17Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t18Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t1Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t2Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t3Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t4Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t5Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="t6Timer" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="t8Timer" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Map Set Object -->
<xsd:complexType name="VstpMapSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="mapSetId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="messageRouteCongestion" type="messageRouteCongestionType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="relativeCost" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rspName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ssn" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="subsystemRoutingMessage" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="subsystemStatusOption" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="threshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="uniqueIdentifier" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="weight" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Mrn Set Object -->
<xsd:complexType name="VstpMrnSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="mrnSetId" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="relativeCost" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rspName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="threshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="uniqueIdentifier" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="weight" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Mtp Screen Set Object -->
<xsd:complexType name="VstpMtpScreenSet">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="nextScrRuleGroupName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="nsfi" type="nsfiType"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Mtp Screening Rule Object -->
<xsd:complexType name="VstpMtpScreeningRule">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="area" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="h0Code" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="h1Code" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mainNumberArea" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mainSignalingArea" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nationalPointCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="networkCluster" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="networkClusterMember" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="networkIndicator" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="networkIndicatorCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="nextScrRuleGroupName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="nsfi" type="nsfiMtpScreeningRuleType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="priority" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ruleName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="scrRuleGroupName" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="scrRuleGroupType" type="scrRuleGrpType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serviceIndicator" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="signalingPoint" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="signalingPointId" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="subNumberArea" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="subSignalingArea" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="unitNumber" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="zone" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Remote Host Object -->
<xsd:complexType name="VstpRemoteHost">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="remoteHostName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="remoteHostPort" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="remoteHostPriIPAddress" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="remoteHostSecIPAddress" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Remote Signaling Point Object -->
<xsd:complexType name="VstpRemoteSignalingPoint">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="aliasPointCode1" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="aliasPointCode1DomainType" type="domainType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="aliasPointCode2" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="aliasPointCode2DomainType" type="domainType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="enableBroadcastException" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="mtpPointCode" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ss7DomainType" type="domainType"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Route Object -->
<xsd:complexType name="VstpRoute">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="linksetName" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="remoteSignalingPointName" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routeCost" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Sccp Application Object -->
<xsd:complexType name="VstpSccpApplication">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="appType" type="appsccpType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="ssn" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Sccp Loopset Object -->
<xsd:complexType name="VstpSccpLoopset">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="action" type="actionType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="domain" type="domainType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="pointCodeList" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Sccp Option Object -->
<xsd:complexType name="VstpSccpOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="1" name="class1seq" type="adminStateType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="dfltfallback" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="dfltgttmode" type="dfltgttmodeType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtprgtt" type="mtprgttType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtprgttfallback" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tgtt0" type="tgttType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tgtt1" type="tgttType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tgttudtkey" type="tgttudtkeyType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="tgttxudtkey" type="tgttxudtkeyType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="mtprgttType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="On"/>
<xsd:enumeration value="Off"/>
</xsd:restriction>
</xsd:simpleType>
<!-- VSTP Sccp Service Selector Object -->
<xsd:complexType name="VstpSccpServiceSelector">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="configurationLevel" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="domain" type="sccpserseldomainType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="globalTitleIndicator" type="newGTIType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gttRequired" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="1" name="name" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="1" name="natureOfAddressIndicator" type="natureOfAddressIndicatorType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="natureOfAddressIndicatorValue" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="numberingPlan" type="numberingPlanType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serviceNP" type="serviceNPType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serviceNai" type="serviceNaiType"/>
<xsd:element maxOccurs="1" minOccurs="1" name="serviceName" type="serviceNameType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="snn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="translationType" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Sccp Mnp Option Object -->
<xsd:complexType name="VstpSccpMnpOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="atiackimsi" type="atiackimsiType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atiackmsisdn" type="atiackmsisdnType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atiackrn" type="atiackrnType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atiackvlrnum" type="atiackvlrnumType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atidfltrn" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atidlm" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atientitylen" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atinptype" type="atinpType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atisnai" type="atisnaiType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="atisupplocinfo" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ativlrnumlen" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc1-mccmnc1" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc10-mccmnc10" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc2-mccmnc2" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc3-mccmnc3" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc4-mccmnc4" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc5-mccmnc5" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc6-mccmnc6" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc7-mccmnc7" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc8-mccmnc8" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ccnc9-mccmnc9" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="crptt" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defcc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defmapvr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defmcc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defmnc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="defndc" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="delccprefix" type="delccprefixType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="dngtzerofill" type="dngtzerofillType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="encdnpsdnnotfound" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="encdnpsptnone" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="encodecug" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="encodenps" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpcutnpaste" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpdra" type="inpdraType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpdranai" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpdranp" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpnec" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inprelcause" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpsnai1-cdpanai1" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpsnai2-cdpanai2" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpsnai3-cdpanai3" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpsnai4-cdpanai4" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpsnai5-cdpanai5" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="inpsprestype" type="inpspresType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mnpcrp" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mnpnpdbunavl" type="mnpnpdbunavlType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msisdntrunc" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msrndig" type="msrndigType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msrnlen" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msrnnai" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="msrnnp" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtmmsackn" type="mtsmsacknType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtmmsentylen" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtmmsgta" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtmmslen" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtmmstype" type="mtsmsType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmsackn" type="mtsmsacknType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmschksrc" type="dngtzerofillType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmsdltr" type="mtsmsdltrType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmsdltrv" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmsimsi" type="mtsmsimsiType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmsnakerr" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmsnni" type="mtsmsnniType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmsnp" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="mtsmstype" type="mtsmsType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc1" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc10" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc2" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc3" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc4" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc5" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc6" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc7" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc8" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="multcc9" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="serverpfx" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="srfaddr" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="srfnai" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="srfnp" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sridn" type="sridnType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sridnnotfound" type="sridnnotfoundType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="srismdn" type="sridnType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="srismgttrtg" type="cnvClgItuType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="srvcrelaymapset" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<!-- VSTP Alarm Aggregation Option Object -->
<xsd:complexType name="VstpAlarmAggregationOption">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="alarmBudget" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="associationCriticalAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="associationMajorAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="linkCriticalAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="linkMajorAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="linksetCriticalAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="routeCriticalAggAlarmThreshold" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="1" name="rspCriticalAggAlarmThreshold" type="xsd:integer"/>
</xsd:sequence>
</xsd:complexType>
<!-- END LOADGEN ATTRIBUTE DEFINITIONS -->
<xsd:simpleType name="connectionModeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Client"/>
<xsd:enumeration value="Server"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="connType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="M2pa"/>
<xsd:enumeration value="M3ua"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="dirType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Atoi"/>
<xsd:enumeration value="Both"/>
<xsd:enumeration value="Itoa"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="gtixlatType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="22"/>
<xsd:enumeration value="24"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="adminStateType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Disabled"/>
<xsd:enumeration value="Enabled"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="actType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Disc"/>
<xsd:enumeration value="Dup"/>
<xsd:enumeration value="Fwd"/>
<xsd:enumeration value="Tcaperr"/>
<xsd:enumeration value="Udts"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="cgpcogmsgType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Cgpcicmsg"/>
<xsd:enumeration value="Dflt"/>
<xsd:enumeration value="Opcicmsg"/>
<xsd:enumeration value="Provcgpc"/>
<xsd:enumeration value="Remove"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="cpcsType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Atinp"/>
<xsd:enumeration value="Eir"/>
<xsd:enumeration value="Gport"/>
<xsd:enumeration value="Inpq"/>
<xsd:enumeration value="Stp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="pcsType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Cpc"/>
<xsd:enumeration value="Spc"/>
<xsd:enumeration value="Tpc"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="domainType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Ansi"/>
<xsd:enumeration value="Itui"/>
<xsd:enumeration value="Itui_s"/>
<xsd:enumeration value="Itun"/>
<xsd:enumeration value="Itun24"/>
<xsd:enumeration value="Itun_s"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="riType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Gt"/>
<xsd:enumeration value="Ssn"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="cgpcactionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Dflt"/>
<xsd:enumeration value="Ignore"/>
<xsd:enumeration value="Remove"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="defmapvrType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="V1"/>
<xsd:enumeration value="V2"/>
<xsd:enumeration value="V3"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="fallbackType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="No"/>
<xsd:enumeration value="Sysdflt"/>
<xsd:enumeration value="Yes"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="pkgType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Ansiabort"/>
<xsd:enumeration value="Ansiuni"/>
<xsd:enumeration value="Any"/>
<xsd:enumeration value="Bgn"/>
<xsd:enumeration value="Cnt"/>
<xsd:enumeration value="Cwop"/>
<xsd:enumeration value="Cwp"/>
<xsd:enumeration value="End"/>
<xsd:enumeration value="Ituabort"/>
<xsd:enumeration value="Ituuni"/>
<xsd:enumeration value="Qwop"/>
<xsd:enumeration value="Qwp"/>
<xsd:enumeration value="Resp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="splitActionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="None"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="translateIndicatorType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Dpc"/>
<xsd:enumeration value="Dpcngt"/>
<xsd:enumeration value="Dpcssn"/>
<xsd:enumeration value="None"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="newGTIType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="TtNumEncodingNature"/>
<xsd:enumeration value="TtOnly"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="globalTitleIndicatorType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="NoGlobal"/>
<xsd:enumeration value="TtNumEncodingNature"/>
<xsd:enumeration value="TtOnly"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="natureOfAddressIndicatorType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="International"/>
<xsd:enumeration value="National"/>
<xsd:enumeration value="Reserved"/>
<xsd:enumeration value="Subscriber"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="numberingPlanType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="E164"/>
<xsd:enumeration value="E210"/>
<xsd:enumeration value="E212"/>
<xsd:enumeration value="E214"/>
<xsd:enumeration value="F69"/>
<xsd:enumeration value="Generic"/>
<xsd:enumeration value="Private"/>
<xsd:enumeration value="X121"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="domType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Ansi"/>
<xsd:enumeration value="Cross"/>
<xsd:enumeration value="Itu"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="gttSETType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Cdgta"/>
<xsd:enumeration value="Cdssn"/>
<xsd:enumeration value="Cggta"/>
<xsd:enumeration value="Cgpc"/>
<xsd:enumeration value="Cgssn"/>
<xsd:enumeration value="Imsi"/>
<xsd:enumeration value="Msisdn"/>
<xsd:enumeration value="Opc"/>
<xsd:enumeration value="Opcode"/>
<xsd:enumeration value="Smrpda"/>
<xsd:enumeration value="Smrpoa"/>
<xsd:enumeration value="Vlrnb"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="entType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="HomeRn"/>
<xsd:enumeration value="HomeSmsc"/>
<xsd:enumeration value="CdpnPfx"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="gttmodeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Cd"/>
<xsd:enumeration value="Fcd"/>
<xsd:enumeration value="Fcg"/>
<xsd:enumeration value="Fcgfcd"/>
<xsd:enumeration value="Fcdfcg"/>
<xsd:enumeration value="Sysdflt"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="adapType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="HomeRn"/>
<xsd:enumeration value="HomeSmsc"/>
<xsd:enumeration value="CdpnPfx"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="cnvClgItuType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="On"/>
<xsd:enumeration value="Off"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="messageRouteCongestionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Default"/>
<xsd:enumeration value="Yes"/>
<xsd:enumeration value="No"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="nsfiType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="BlkDpc"/>
<xsd:enumeration value="BlkOpc"/>
<xsd:enumeration value="Dpc"/>
<xsd:enumeration value="Opc"/>
<xsd:enumeration value="Sio"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="nsfiMtpScreeningRuleType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="AftDstn"/>
<xsd:enumeration value="BlkDpc"/>
<xsd:enumeration value="BlkOpc"/>
<xsd:enumeration value="Dpc"/>
<xsd:enumeration value="Fail"/>
<xsd:enumeration value="Opc"/>
<xsd:enumeration value="Sio"/>
<xsd:enumeration value="Stop"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="scrRuleGrpType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="AftDstn"/>
<xsd:enumeration value="BlkDpc"/>
<xsd:enumeration value="BlkOpc"/>
<xsd:enumeration value="Dpc"/>
<xsd:enumeration value="Opc"/>
<xsd:enumeration value="Sio"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="appsccpType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Eir"/>
<xsd:enumeration value="Atinp"/>
<xsd:enumeration value="Inpq"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="actionType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="discardOnly"/>
<xsd:enumeration value="notifyOnly"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="dfltgttmodeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Cd"/>
<xsd:enumeration value="Fcd"/>
<xsd:enumeration value="Fcg"/>
<xsd:enumeration value="Fcgfcd"/>
<xsd:enumeration value="Fcdfcg"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="tgttType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Both"/>
<xsd:enumeration value="None"/>
<xsd:enumeration value="Udt"/>
<xsd:enumeration value="Xudt"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="tgttudtkeyType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Enhmtp"/>
<xsd:enumeration value="Mtp"/>
<xsd:enumeration value="Sccp"/>
<xsd:enumeration value="Tcap"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="tgttxudtkeyType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Enhmtp"/>
<xsd:enumeration value="Mtp"/>
<xsd:enumeration value="Sccp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="sccpserseldomainType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Ansi"/>
<xsd:enumeration value="Intui"/>
<xsd:enumeration value="Itun"/>
<xsd:enumeration value="Itun24"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="serviceNameType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Eir"/>
<xsd:enumeration value="Atinp"/>
<xsd:enumeration value="Gport"/>
<xsd:enumeration value="Idpr"/>
<xsd:enumeration value="Mosms"/>
<xsd:enumeration value="Gflex"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="serviceNaiType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Ccrndn"/>
<xsd:enumeration value="Intl"/>
<xsd:enumeration value="Natl"/>
<xsd:enumeration value="Rnidn"/>
<xsd:enumeration value="Rnndn"/>
<xsd:enumeration value="Rnsdn"/>
<xsd:enumeration value="Sub"/>
<xsd:enumeration value="Unknown"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="serviceNPType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="E164"/>
<xsd:enumeration value="E212"/>
<xsd:enumeration value="E214"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="msrndigType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="asdrn"/>
<xsd:enumeration value="asdrnccdn"/>
<xsd:enumeration value="asdrndn"/>
<xsd:enumeration value="ccrnasddn"/>
<xsd:enumeration value="ccasdrndn"/>
<xsd:enumeration value="ccgrnrndn"/>
<xsd:enumeration value="ccrngrndn"/>
<xsd:enumeration value="ccrndn"/>
<xsd:enumeration value="grnrn"/>
<xsd:enumeration value="grnrnccdn"/>
<xsd:enumeration value="grnrndn"/>
<xsd:enumeration value="rn"/>
<xsd:enumeration value="rnasd"/>
<xsd:enumeration value="rnasddn"/>
<xsd:enumeration value="rnasdccdn"/>
<xsd:enumeration value="rnccdn"/>
<xsd:enumeration value="rndn"/>
<xsd:enumeration value="rngrn"/>
<xsd:enumeration value="rngrnccdn"/>
<xsd:enumeration value="rngrndn"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="sridnType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="sccp"/>
<xsd:enumeration value="tcap"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="sridnnotfoundType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="gtt"/>
<xsd:enumeration value="srinack"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="dngtzerofillType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="No"/>
<xsd:enumeration value="Yes"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="delccprefixType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="pfxwcc"/>
<xsd:enumeration value="pfx4all"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="mtsmsimsiType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ccrndn"/>
<xsd:enumeration value="dn"/>
<xsd:enumeration value="mccrndn"/>
<xsd:enumeration value="rn"/>
<xsd:enumeration value="rndn"/>
<xsd:enumeration value="srfimsi"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="mtsmsnniType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ccrndn"/>
<xsd:enumeration value="dn"/>
<xsd:enumeration value="mccrndn"/>
<xsd:enumeration value="none"/>
<xsd:enumeration value="rn"/>
<xsd:enumeration value="rndn"/>
<xsd:enumeration value="srfimsi"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="mtsmsType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="all"/>
<xsd:enumeration value="nonsp"/>
<xsd:enumeration value="rn"/>
<xsd:enumeration value="sp"/>
<xsd:enumeration value="sprn"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="mtsmsacknType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="ack"/>
<xsd:enumeration value="nack"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="mtsmsdltrType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="no"/>
<xsd:enumeration value="postrn"/>
<xsd:enumeration value="prern"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="mnpnpdbunavlType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="discard"/>
<xsd:enumeration value="dnnotfound"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="atiackimsiType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="srfimisi"/>
<xsd:enumeration value="asd"/>
<xsd:enumeration value="grn"/>
<xsd:enumeration value="none"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="atiackmsisdnType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="asd"/>
<xsd:enumeration value="asddlmmsisdn"/>
<xsd:enumeration value="grn"/>
<xsd:enumeration value="grndlmmsisdn"/>
<xsd:enumeration value="msisdn"/>
<xsd:enumeration value="none"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="atiackrnType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="asddlmrnsp"/>
<xsd:enumeration value="asddlmsrfimsi"/>
<xsd:enumeration value="grndlmrnsp"/>
<xsd:enumeration value="grndlmsrfimsi"/>
<xsd:enumeration value="none"/>
<xsd:enumeration value="rn"/>
<xsd:enumeration value="rnsp"/>
<xsd:enumeration value="rnspdlmasd"/>
<xsd:enumeration value="rnspdlmgrn"/>
<xsd:enumeration value="srfimsi"/>
<xsd:enumeration value="srfimsidlmasd"/>
<xsd:enumeration value="srfimsidlmgrn"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="atiackvlrnumType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="asd"/>
<xsd:enumeration value="asddlmrnsp"/>
<xsd:enumeration value="asddlmsrfimsi"/>
<xsd:enumeration value="asdmsisdn"/>
<xsd:enumeration value="grndlmrnsp"/>
<xsd:enumeration value="grndlmsrfimsi"/>
<xsd:enumeration value="msisdn"/>
<xsd:enumeration value="rn"/>
<xsd:enumeration value="rnmsisdn"/>
<xsd:enumeration value="rnsp"/>
<xsd:enumeration value="rnspmsisdn"/>
<xsd:enumeration value="rnspdlmasd"/>
<xsd:enumeration value="rnspdlmgrn"/>
<xsd:enumeration value="srfimsi"/>
<xsd:enumeration value="srfimsidlmasd"/>
<xsd:enumeration value="srfimsidlmgrn"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="atinpType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="always"/>
<xsd:enumeration value="any"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="atisnaiType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="intl"/>
<xsd:enumeration value="nat"/>
<xsd:enumeration value="nai"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="inpdraType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="asdrn"/>
<xsd:enumeration value="asdrnccdn"/>
<xsd:enumeration value="asdrnnecdn"/>
<xsd:enumeration value="ccasdrndn"/>
<xsd:enumeration value="ccdrdn"/>
<xsd:enumeration value="ccgrndn"/>
<xsd:enumeration value="ccgrnrndn"/>
<xsd:enumeration value="ccrngrndn"/>
<xsd:enumeration value="ccrnasddn"/>
<xsd:enumeration value="grn"/>
<xsd:enumeration value="grndn"/>
<xsd:enumeration value="grnrn"/>
<xsd:enumeration value="grnrndn"/>
<xsd:enumeration value="grnrnccdn"/>
<xsd:enumeration value="grnrnnecdn"/>
<xsd:enumeration value="homerndn"/>
<xsd:enumeration value="rn"/>
<xsd:enumeration value="rnasd"/>
<xsd:enumeration value="rnasdccdn"/>
<xsd:enumeration value="rnasdnecdn"/>
<xsd:enumeration value="rndn"/>
<xsd:enumeration value="rnnecdn"/>
<xsd:enumeration value="rngrn"/>
<xsd:enumeration value="rngrndn"/>
<xsd:enumeration value="rngrnccdn"/>
<xsd:enumeration value="rngrnnecdn"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="inpspresType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="connect"/>
<xsd:enumeration value="continue"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="comagentArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="connectiongroup" type="ComagentConnectionGroup"/>
<xsd:element name="remoteserver" type="ComagentRemoteServer"/>
</xsd:choice>
</xsd:complexType>
<!--
- Copyright (C) 2013, 2018, Oracle and/or its affiliates. All rights reserved.
-->
<xsd:complexType name="diameterArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="afTopologyHidingCfgSet" type="AfTopologyHidingCfgSet"/>
<xsd:element name="applicationId" type="ApplicationId"/>
<xsd:element name="applicationPriorityOption" type="ApplicationPriorityOption"/>
<xsd:element name="applicationRouteRule" type="ApplicationRouteRule"/>
<xsd:element name="applicationRouteTable" type="ApplicationRouteTable"/>
<xsd:element name="avpRemovalList" type="AvpRemovalList"/>
<xsd:element name="cexConfigurationSet" type="CexCfgSet"/>
<xsd:element name="capacityConfigurationSet" type="CapCfgSet"/>
<xsd:element name="cexParameter" type="CexParameter"/>
<xsd:element name="commandCode" type="CommandCode"/>
<xsd:element name="connection" type="Connection"/>
<xsd:element name="connectionAlarmGroup" type="ConnectionAlarmGroup"/>
<xsd:element name="connectionConfigurationSet" type="ConnCfgSet"/>
<xsd:element name="dnsOption" type="DnsOption"/>
<xsd:element name="dpdAttributeSet" type="DpdAttributeSet"/>
<xsd:element name="dpdDnsSet" type="DpdDnsSet"/>
<xsd:element name="dpdRealm" type="DpdRealm"/>
<xsd:element name="egressMessageThrottlingConfigurationSet" type="MsgThrottlingCfgSet"/>
<xsd:element name="egressThrottleGroup" type="EgressThrottleGroup"/>
<xsd:element name="etl" type="Etl"/>
<xsd:element name="hssTopologyHidingCfgSet" type="HssTopologyHidingCfgSet"/>
<xsd:element name="ipfeOption" type="IpfeOption"/>
<xsd:element name="ipfeTargetSet" type="IpfeTargetSet"/>
<xsd:element name="localNode" type="LocalNode"/>
<xsd:element name="mccMncMapping" type="MccMncMapping"/>
<xsd:element name="messageCopyConfigurationSet" type="MessageCopyCfgSet"/>
<xsd:element name="messagePriorityConfigurationSet" type="MsgPriorityCfgSet"/>
<xsd:element name="mmeTopologyHidingCfgSet" type="MmeTopologyHidingCfgSet"/>
<xsd:element name="mpProfile" type="MpProfile"/>
<xsd:element name="mpProfileAssignment" type="MpProfileAssignment"/>
<xsd:element name="option" type="Option"/>
<xsd:element name="pathTopologyHidingCfgSet" type="PathTopologyHidingCfgSet"/>
<xsd:element name="pcrfTopologyHidingCfgSet" type="PcrfTopologyHidingCfgSet"/>
<xsd:element name="peerNode" type="PeerNode"/>
<xsd:element name="peerNodeAlarmGroup" type="PeerNodeAlarmGroup"/>
<xsd:element name="peerNodeGroup" type="PeerNodeGroup"/>
<xsd:element name="peerRouteRule" type="PeerRouteRule"/>
<xsd:element name="peerRouteTable" type="PeerRouteTable"/>
<xsd:element name="pendingAnswerTimer" type="PendingAnswerTimer"/>
<xsd:element name="pendingTransactionLimitingConfigurationSet" type="PendTransCfgSet"/>
<xsd:element name="protectedNetwork" type="ProtectedNetwork"/>
<xsd:element name="rateLimitingConfigurationSet" type="RateCfgSet"/>
<xsd:element name="rerouteOnAnswer" type="RerouteOnAnswer"/>
<xsd:element name="rfMessageCopy" type="RfMessageCopy"/>
<xsd:element name="routeGroup" type="RouteGroup"/>
<xsd:element name="routeList" type="RouteList"/>
<xsd:element name="routingOptionSet" type="RoutingOptionSet"/>
<xsd:element name="trafficThrottleGroup" type="TrafficThrottleGroup"/>
<xsd:element name="trafficThrottlePoint" type="TrafficThrottlePoint"/>
<xsd:element name="trafficThrottlePointConfigurationSet" type="TrafficThrPointCfgSet"/>
<xsd:element name="transactionConfigurationSet" type="TransactionCfgSet"/>
<xsd:element name="trustedNetworkList" type="TrustedNetworkList"/>
</xsd:choice>
</xsd:complexType>
<!--
- Copyright (C) 2013, 2019, Oracle and/or its affiliates. All rights reserved.
-->
<xsd:complexType name="fabrArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="addressResolution" type="AddressResolution"/>
<xsd:element name="defaultDestination" type="DefaultDestination"/>
<xsd:element name="option" type="FabrOption"/>
<xsd:element name="routingException" type="RoutingException"/>
<xsd:element name="supportedApplication" type="SupportedApplication"/>
</xsd:choice>
</xsd:complexType>
<!--
- Copyright (C) 2013, 2020, Oracle and/or its affiliates. All rights reserved.
-->
<xsd:complexType name="radiusArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="ingressStatusServerConfigurationSet" type="IngressStatusServerConfigurationSet"/>
<xsd:element name="messageAuthenticatorConfigurationSet" type="MessageAuthenticatorConfigurationSet"/>
<xsd:element name="messageConversionConfigurationSet" type="MessageConversionConfigurationSet"/>
<xsd:element name="nasNode" type="NasNode"/>
<xsd:element name="networkOption" type="NetworkOption"/>
<xsd:element name="radiusRoutingTable" type="RadiusRoutingTable"/>
<xsd:element name="sharedSecretConfigurationSet" type="SharedSecretConfigurationSet"/>
</xsd:choice>
</xsd:complexType>
<!--
- Copyright (C) 2013, 2019, Oracle and/or its affiliates. All rights reserved.
-->
<xsd:complexType name="rbarArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="addressRange" type="RbarAddressRange"/>
<xsd:element name="addressResolution" type="RbarAddressResolution"/>
<xsd:element name="addressTable" type="RbarAddressTable"/>
<xsd:element name="destination" type="RbarDestination"/>
<xsd:element name="domainAddress" type="RbarDomainAddress"/>
<xsd:element name="individualAddress" type="RbarIndividualAddress"/>
<xsd:element name="option" type="RbarOption"/>
<xsd:element name="routingException" type="RbarRoutingException"/>
<xsd:element name="supportedApplication" type="RbarSupportedApplication"/>
</xsd:choice>
</xsd:complexType>
<!--
- Copyright (C) 2013, 2018, Oracle and/or its affiliates. All rights reserved.
-->
<xsd:complexType name="sbrArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="databaseResizingPlan" type="DatabaseResizingPlan"/>
<xsd:element name="databaseOption" type="DatabaseOption"/>
<xsd:element name="sbrDatabase" type="SbrDatabase"/>
<xsd:element name="dataMigrationPlan" type="DataMigrationPlan"/>
</xsd:choice>
</xsd:complexType>
<xsd:simpleType name="sgLevel">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="A"/>
<xsd:enumeration value="B"/>
<xsd:enumeration value="C"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="serverRole">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Noam"/>
<xsd:enumeration value="Soam"/>
<xsd:enumeration value="Mp"/>
<xsd:enumeration value="QueryServer"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="deviceType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Bonding"/>
<xsd:enumeration value="Vlan"/>
<xsd:enumeration value="Alias"/>
<xsd:enumeration value="Ethernet"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="deviceInterface">
<xsd:sequence>
<xsd:element minOccurs="0" name="ipAddress" type="IPv4orIPv6"/>
<xsd:element name="networkName" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="routeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Net"/>
<xsd:enumeration value="Host"/>
<xsd:enumeration value="Default"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="bootProtoType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="None"/>
<xsd:enumeration value="Dhcp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="monitorType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Mii"/>
<xsd:enumeration value="Arp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="arpValidationType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="None"/>
<xsd:enumeration value="Active"/>
<xsd:enumeration value="Backup"/>
<xsd:enumeration value="All"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="svcAction">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="insert"/>
<xsd:enumeration value="update"/>
<xsd:enumeration value="delete"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="scopeType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Server"/>
<xsd:enumeration value="ServerGroup"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:simpleType name="rolePref">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Default"/>
<xsd:enumeration value="Active"/>
<xsd:enumeration value="Standby"/>
<xsd:enumeration value="Spare"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="ntpServer">
<xsd:sequence>
<xsd:element name="ipAddress" type="IPv4orIPv6"/>
<xsd:element name="prefer" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="networkElement">
<xsd:sequence>
<xsd:element name="name" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="configHostname">
<xsd:sequence>
<xsd:element name="hostname" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="network">
<xsd:sequence>
<xsd:element name="name" type="requiredString"/>
<xsd:element minOccurs="0" name="UUID" type="xsd:string"/>
<xsd:element minOccurs="0" name="neName" type="xsd:string"/>
<xsd:element minOccurs="0" name="type" type="xsd:string"/>
<xsd:element name="vlanId" type="xsd:string"/>
<xsd:element name="ipAddress" type="IPv4orIPv6"/>
<xsd:element name="subnetMask" type="IPv4orIPv6NetMask"/>
<xsd:element minOccurs="0" name="gatewayAddress" type="IPv4orIPv6"/>
<xsd:element name="isDefault" type="xsd:boolean"/>
<xsd:element name="isRoutable" type="xsd:boolean"/>
<xsd:element name="locked" type="xsd:boolean"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="ntpref">
<xsd:sequence>
<xsd:element name="NTP_Reference" type="IPv4"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="servicePath">
<xsd:sequence>
<xsd:element name="name" type="requiredString"/>
<xsd:element name="intraSitePath" type="requiredString"/>
<xsd:element name="interSitePath" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="server">
<xsd:sequence>
<xsd:element name="hostname" type="requiredString"/>
<xsd:element name="networkElementName" type="requiredString"/>
<xsd:element minOccurs="0" name="serverGroupName" type="xsd:string"/>
<xsd:element name="profileName" type="requiredString"/>
<xsd:element name="location" type="xsd:string"/>
<xsd:element name="role" type="serverRole"/>
<xsd:element name="systemId" type="xsd:string"/>
<xsd:element name="ntpServers">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="ntpServer" type="ntpServer"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="serverGroup">
<xsd:sequence>
<xsd:element name="name" type="requiredString"/>
<xsd:element name="level" type="sgLevel"/>
<xsd:element name="parentSgName" type="xsd:string"/>
<xsd:element name="functionName" type="xsd:string"/>
<xsd:element minOccurs="0" name="numWanRepConn" type="xsd:positiveInteger"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="networkDevice">
<xsd:sequence>
<xsd:element minOccurs="0" name="port" type="xsd:string"/>
<xsd:element name="type" type="deviceType"/>
<xsd:element minOccurs="0" name="status" type="xsd:string"/>
<xsd:element minOccurs="0" name="UUID" type="xsd:string"/>
<xsd:element name="hostname" type="requiredString"/>
<xsd:element minOccurs="0" name="interfaces">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" minOccurs="0" name="interface" type="deviceInterface"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element name="options">
<xsd:complexType>
<xsd:all>
<xsd:element minOccurs="1" name="onboot" type="xsd:boolean"/>
<xsd:element minOccurs="1" name="bootProto" type="bootProtoType"/>
<xsd:element minOccurs="0" name="mtu" type="xsd:integer"/>
<xsd:element minOccurs="0" name="baseDevice">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" minOccurs="1" name="baseDeviceItem" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
<xsd:element maxOccurs="1" minOccurs="0" name="monitorType" type="monitorType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="primary" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="miimon" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="updelay" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="downdelay" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="arpInterval" type="xsd:integer"/>
<xsd:element maxOccurs="1" minOccurs="0" name="arpValidate" type="arpValidationType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="arpIpTarget" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="hwAddr" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="persistentDhclient" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ethtoolOpts" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ethtoolAccelOpts" type="xsd:string"/>
</xsd:all>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="networkRoute">
<xsd:sequence>
<xsd:element name="hostname" type="xsd:string"/>
<xsd:element minOccurs="0" name="UUID" type="xsd:string"/>
<xsd:element name="type" type="routeType"/>
<xsd:element name="port" type="xsd:string"/>
<xsd:element minOccurs="0" name="networkAddress" type="IPv4orIPv6"/>
<xsd:element minOccurs="0" name="subnetMask" type="IPv4orIPv6NetMask"/>
<xsd:element name="gatewayAddress" type="IPv4orIPv6"/>
<xsd:element name="scope" type="xsd:string"/>
<xsd:element name="scopeType" type="scopeType"/>
<xsd:element minOccurs="0" name="status" type="xsd:string"/>
<xsd:element minOccurs="0" name="statusDetails" type="xsd:string"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="resourceDomain">
<xsd:sequence>
<xsd:element name="name" type="requiredString"/>
<xsd:element name="profileName" type="xsd:string"/>
<xsd:element minOccurs="0" name="sgNames">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="sgName" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="place">
<xsd:sequence>
<xsd:element name="name" type="requiredString"/>
<xsd:element minOccurs="0" name="parentPlaceName" type="xsd:string"/>
<xsd:element name="typeName" type="requiredString"/>
<xsd:element minOccurs="0" name="serverList">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="serverListItem" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="placeAssociation">
<xsd:sequence>
<xsd:element name="name" type="requiredString"/>
<xsd:element name="typeName" type="requiredString"/>
<xsd:element minOccurs="0" name="placeList">
<xsd:complexType>
<xsd:sequence>
<xsd:element maxOccurs="unbounded" name="placeListItem" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="dscpInterfaceRule">
<xsd:sequence>
<xsd:element minOccurs="0" name="UUID" type="xsd:string"/>
<xsd:element name="interface" type="requiredString"/>
<xsd:element name="dscp" type="xsd:integer"/>
<xsd:element name="protocol" type="protocolType"/>
<xsd:element name="scope" type="xsd:string"/>
<xsd:element name="scopeType" type="scopeType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:simpleType name="protocolType">
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Tcp"/>
<xsd:enumeration value="Sctp"/>
</xsd:restriction>
</xsd:simpleType>
<xsd:complexType name="dscpPortRule">
<xsd:sequence>
<xsd:element minOccurs="0" name="UUID" type="xsd:string"/>
<xsd:element name="port" type="xsd:integer"/>
<xsd:element name="dscp" type="xsd:integer"/>
<xsd:element name="protocol" type="protocolType"/>
<xsd:element name="scope" type="xsd:string"/>
<xsd:element name="scopeType" type="scopeType"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="vip">
<xsd:sequence>
<xsd:element minOccurs="0" name="UUID" type="xsd:string"/>
<xsd:element name="serverGroupName" type="requiredString"/>
<xsd:element name="ipAddress" type="IPv4orIPv6"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="member">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="haRolePreference" type="rolePref"/>
<xsd:element maxOccurs="1" minOccurs="1" name="hostname" type="requiredString"/>
<xsd:element maxOccurs="1" minOccurs="1" name="serverGroupName" type="requiredString"/>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="topoArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="configHostname" type="configHostname"/>
<xsd:element name="networkElement" type="networkElement"/>
<xsd:element name="network" type="network"/>
<xsd:element name="servicePath" type="servicePath"/>
<xsd:element name="server" type="server"/>
<xsd:element name="serverGroup" type="serverGroup"/>
<xsd:element name="networkDevice" type="networkDevice"/>
<xsd:element name="networkRoute" type="networkRoute"/>
<xsd:element name="resourceDomain" type="resourceDomain"/>
<xsd:element name="place" type="place"/>
<xsd:element name="placeAssociation" type="placeAssociation"/>
<xsd:element name="dscpInterfaceRule" type="dscpInterfaceRule"/>
<xsd:element name="dscpPortRule" type="dscpPortRule"/>
<xsd:element name="member" type="member"/>
<xsd:element name="vip" type="vip"/>
</xsd:choice>
</xsd:complexType>
<xsd:complexType name="vstpArea">
<xsd:choice maxOccurs="unbounded" minOccurs="0">
<xsd:element name="connection" type="VstpConnection"/>
<xsd:element name="connectionconfigurationset" type="VstpConnCfgSet"/>
<xsd:element name="defaultconversion" type="VstpDefaultConversion"/>
<xsd:element name="featureadminstate" type="VstpFeatureAdminState"/>
<xsd:element name="gttaction" type="VstpGttAction"/>
<xsd:element name="gttaddress" type="VstpGttTitleAddress"/>
<xsd:element name="gttmod" type="VstpGttMod"/>
<xsd:element name="gttselector" type="VstpGttSelector"/>
<xsd:element name="gttset" type="VstpGttSet"/>
<xsd:element name="gttactionset" type="VstpGttActionSet"/>
<xsd:element name="homeentity" type="VstpHomeEntity"/>
<xsd:element name="link" type="VstpLink"/>
<xsd:element name="linkset" type="VstpLinkSet"/>
<xsd:element name="localhost" type="VstpLocalHost"/>
<xsd:element name="localsignalingpoint" type="VstpLocalSignalingPoint"/>
<xsd:element name="m2paoption" type="VstpM2paOption"/>
<xsd:element name="m3rloption" type="VstpM3rlOption"/>
<xsd:element name="mapset" type="VstpMapSet"/>
<xsd:element name="mrnset" type="VstpMrnSet"/>
<xsd:element name="mtpscreenset" type="VstpMtpScreenSet"/>
<xsd:element name="mtpscreeningrule" type="VstpMtpScreeningRule"/>
<xsd:element name="remotehost" type="VstpRemoteHost"/>
<xsd:element name="remotesignalingpoint" type="VstpRemoteSignalingPoint"/>
<xsd:element name="route" type="VstpRoute"/>
<xsd:element name="sccpapplication" type="VstpSccpApplication"/>
<xsd:element name="sccploopset" type="VstpSccpLoopset"/>
<xsd:element name="sccpoption" type="VstpSccpOption"/>
<xsd:element name="sccpserviceselector" type="VstpSccpServiceSelector"/>
<xsd:element name="sccpmnpoption" type="VstpSccpMnpOption"/>
<xsd:element name="vstpalarmaggregationoption" type="VstpAlarmAggregationOption"/>
</xsd:choice>
</xsd:complexType>
<xsd:element name="configuration">
<xsd:complexType>
<xsd:all>
<xsd:element minOccurs="0" name="comagent" type="comagentArea"/>
<xsd:element minOccurs="0" name="diameter" type="diameterArea"/>
<xsd:element minOccurs="0" name="fabr" type="fabrArea"/>
<xsd:element minOccurs="0" name="radius" type="radiusArea"/>
<xsd:element minOccurs="0" name="rbar" type="rbarArea"/>
<xsd:element minOccurs="0" name="sbr" type="sbrArea"/>
<xsd:element minOccurs="0" name="topo" type="topoArea"/>
<xsd:element minOccurs="0" name="vstp" type="vstpArea"/>
</xsd:all>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Copyright
Oracle Communications Diameter Signaling Router Machine to Machine Interface
Copyright 2013, 2017, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.