Request

The <updateSubscriber> request provisions IMSI and MSISDN routing data and can provision subscriber data. The request updates existing routing entities, and creates any new routing entities that do not exist.

The request allows for the provisioning of IMSI, MSISDN, or combinations of IMSI and MSISDNs to be associated with eight different destinations.

A destination name can be specified as "none", which removes the association of that destination from the specified routing entity(s).

Semantic Rules (all requests)

Semantic Rules (requests that do not specify the group attribute or specify group="n")

Semantic (requests that specify attribute group="y")

Request Format

<updateSubscriber ent="subscriberRouting" ns="dsr" [resonly="resonly"]
                  [id="id"] [timeout="timeout"] [group="group"]>
[   <deleteAccountId>deleteAccountId</deleteAccountId> ]
[
    <deleteImsi>deleteImsi</deleteImsi>
    …
    <deleteImsi>deleteImsi</deleteImsi>
]
[
    <deleteMsisdn>deleteMsisdn</deleteMsisdn>
    …
    <deleteMsisdn>deleteMsisdn</deleteMsisdn>
]
[   <accountId>accountId</accountId> ]
[
    <imsi>imsi</imsi>
    …
    <imsi>imsi</imsi>
]
[
    <msisdn>msisdn</msisdn>
    …
    <msisdn>msisdn</msisdn>
]
[   <imshss>imshss</imshss>       ]
[   <ltehss>ltehss</ltehss>       ]
[   <pcrf>pcrf</pcrf>             ]
[   <ocs>ocs</ocs>                ]
[   <ofcs>ofcs</ofcs>             ]
[   <aaa>aaa</aaa>                ]
[   <userdef1>userdef1</userdef1> ]
[   <userdef2>userdef2</userdef2> ]
</updateSubscriber>

Request Parameters

<updateSubscriber> Request Parameters (XML)
Parameter Description Values
ent The entity name within the global schema. subscriberRouting
ns The namespace within the global schema dsr
resonly (Optional) Indicates whether the response should consist of the result only, without including the original request in the response
  • y - Only provide the result, do not include the original request (default)
  • n - Include the original request in the response
id (Optional) Transaction id value provided in request and passed back in the response 1-4294967295
timeout (Optional) The amount of time (in seconds) to wait to before being able to perform a write if another connection is performing a write, or has a transaction open. Clients waiting to write are processed in the order that their requests were received.

If the request is being performed within a transaction, this parameter will have no effect, as the client already has a transaction open.

0 (return immediately if not available) to 3600 seconds (default is 0)
group (Optional) Indicates if relationships between a group of related IMSI and/or MSISDN routing entities and Account ID value should be created/updated
  • y - Create new or update existing subscriber relationships and update destinations
  • n - Only update destinations, not relationships between routing entities (default)
deleteAccountId (Optional) A user-defined Account ID value to delete 1 to 26 decimal digits
deleteImsi (Optional) An IMSI (specified in E.212 format) value to delete 10 to 15 numeric digits
deleteMsisdn (Optional) An MSISDN (specified in E.164 international public telecommunication numbering plan format) value to delete 8 to 15 decimal digits
accountId (Optional) A user-defined Account ID value to add or update 1 to 26 numeric digits
imsi (Optional) An IMSI (specified in E.212 format) to add or update 10 to 15 numeric digits
msisdn (Optional) An MSISDN (specified in E.164 international public telecommunication numbering plan format) to add or update 8 to 15 numeric digits
imshss (Optional) The name of the IMS HSS destination A string with 1 to 32 characters
ltehss (Optional) The name of the LTE HSS destination A string with 1 to 32 characters
pcrf (Optional) The name of the PCRF destination A string with 1 to 32 characters
ocs (Optional) The name of the OCS destination A string with 1 to 32 characters
ofcs (Optional) The name of the OFCS destination A string with 1 to 32 characters
aaa (Optional) The name of the AAA server destination A string with 1 to 32 characters
userdef1 (Optional) The name of the first user defined destination A string with 1 to 32 characters
userdef2 (Optional) The name of the second user defined destination A string with 1 to 32 characters