The <updateSubscriber> request provisions IMSI and MSISDN routing data and can provision subscriber data. See Subscriber and Routing Data for a description of subscriber and routing data.
This request provisions stand-alone IMSI and MSISDN routing entities and/or subscriber data. Each routing entity contains up to eight destination names. Each destination contains FQDN and realm values, which are used for routing messages.
The request can also be used to update destination names in existing routing entities or create new routing entities, regardless of whether the group="y" attribute is specified. These destination changes are applied to all specified IMSI and MSISDN routing entities. If all of the specified IMSI, MSISDN and Account ID values are assigned to one subscriber, the destination changes are also applied to all of the subscriber's routing entities.
If the group="y" attribute is specified, then the changes are also applied to any specified new or existing standalone routing entities, which are assigned to the subscriber.
The request can also be used to remove a destination value from existing IMSI and/or MSISDN routing entities by specifying "none" as the destination name.
<updateSubscriberRequest [timeout="timeout"] [group="group"]> <addressList> [ <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> ] </addressList> <destinationList> [ <imshss>imshss</imshss> ] [ <ltehss>ltehss</ltehss> ] [ <pcrf>pcrf</pcrf> ] [ <ocs>ocs</ocs> ] [ <ofcs>ofcs</ofcs> ] [ <aaa>aaa</aaa> ] [ <userdef1>userdef1</userdef1> ] [ <userdef2>userdef2</userdef2> ] </destinationList> </updateSubscriberRequest>
Parameter | Description | Values |
---|---|---|
timeout (Optional) | The amount of time (in seconds) to wait before being able to perform a write if another connection is performing a write, or has a transaction open. Clients waiting to write will be 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. |
|
addressList | XML tag that contains a list of addresses to be created or updated. | Must have at least 1 of the following tags and values:
|
deleteAccountId (Optional) | A user-defined Account ID value to delete. | 1 to 26 numeric 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 numeric 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) value to add or update. | 10 to 15 numeric digits. |
msisdn (Optional) | An MSISDN (specified in E.164 international public telecommunication numbering plan format) value to add or update. | 8 to 15 numeric digits. |
destinationList (Optional) | XML tag that contains a list of destination values to update or set in the routing entity(s). | Can be empty, or contain any of the following destination tags and values: imshss, ltehss, pcrf, ocs, ofcs, aaa, userdef1, and/or userdef2. |
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. |