6.2.3 Resources
29.5623GPP5G SystemHome Subscriber Server (HSS) servicesRelease 18Stage 3TS
6.2.3.1 Overview
Figure 6.2.3.1-1: Resource URI structure of the Nhss_imsSDM API
Figure 6.2.3.1-2: Resource URI structure of the Nhss_imsSDM API
Table 6.2.3.1-1 provides an overview of the resources and applicable HTTP methods.
Table 6.2.3.1-1: Resources and methods overview
Resource name |
Resource URI |
HTTP method or custom operation |
Description |
Repository Data |
/{imsUeId}/repository-data/{serviceIndication} |
GET |
Retrieve repository data for a service indication |
DELETE |
Delete repository data for a service indication |
||
PUT |
Update repository data for a service indication |
||
Repository Data List (Document) |
/{imsUeId}/repository-data |
GET |
Retrieve multiple repository data for a list of service indications |
IMS Associated Identities |
/{imsUeId}/identities/ims-associated-identities |
GET |
Retrieve the UE’s IMS associated identities (implicit and alias) |
MSISDNs |
/{imsUeId}/identities/msisdns |
GET |
Retrieve the UE’s MSISDNs (basic and additional) |
PrivateIdentities |
/{imsUeId}/identities/private-identities |
GET |
Retrieve the UE’s Private Identities (IMPI and IMSI) |
ImeiSvInformation |
/{imsUeId}/identities/imeisv |
GET |
Retrieve the UE’s IMEISV |
IMS Profile Data (Document) |
/{imsUeId}/ims-data/profile-data |
GET |
Retrieve the UE’s subscribed Profile |
Initial Filter Criteria |
/{imsUeId}/ims-data/ |
GET |
Retrieve the UE’s subscribed Initial Filter Criteria |
Service Level Trace Information |
/{imsUeId}/ims-data/profile-data/service-level-trace-info |
GET |
Retrieve the UE’s subscribed Service Level Trace Information |
Service Priority Information |
/{imsUeId}/ims-data/ |
GET |
Retrieve the UE’s subscribed Service Priority Levels |
Charging Information |
/{imsUeId}/ims-data/ |
GET |
Retrieve the UE’s subscribed Charging Information |
IMS Location Data |
/{imsUeId}/ims-data/location-data/server-name |
GET |
Retrieve the UE’s S-CSCF name |
S-CSCF Capabilities |
/{imsUeId}/ims-data/location-data/scscf-capabilities |
GET |
Retrieve the UE’s S-CSCF capabilities (mandatory and/or optional) |
S-CSCF Selection Assistance Information |
/{imsUeId}/ims-data/location-data/scscf-selection-assistance-info |
GET |
Retrieve the UE’s S-CSCF Selection Assistance Information |
IMS Registration Status |
/{imsUeId}/ims-data/ |
GET |
Retrieve the UE’s IMS registration status. |
Subscriptions |
/{imsUeId}/subscriptions |
POST |
Create a subscription |
Individual subscription |
/{imsUeId}/subscriptions/ |
DELETE |
Delete the subscription identified by {subscriptionId}, i.e. unsubscribe |
PATCH |
Modify the sdm-subscription identified by {subscriptionId} |
||
PS Location Information(Document) |
/{imsUeId}/access-data/ |
GET |
Retrieve the UE’s location in PS domain |
CS Location Information(Document) |
/{imsUeId}/access-data/ |
GET |
Retrieve the UE’s location in CS domain |
PsUserState |
/{imsUeId}/access-data/ |
GET |
Retrieve the UE’s state in PS domain |
CsUserState |
/{imsUeId}/access-data/ |
GET |
Retrieve the UE’s state in CS domain |
TadsInfo |
/{imsUeId}/access-data/ |
GET |
Retrieve the UE’s T-ADS information |
UeReachabilityIpSubscriptions |
/{imsUeId}/access-data/ |
POST |
Create a subscription to UE Reachability for IP |
UE reachability individual subscription |
/{imsUeId}/access-data/ |
DELETE |
Delete the subscription to UE reachability for IP identified by {subscriptionId}, i.e. unsubscribe |
PATCH |
Modify the subscription to UE reachability for IP identified by {subscriptionId} |
||
IpAddress |
/{imsUeId}/access-data/ |
GET |
Retrieve the UE’s stored IP Address Secure Binding Information |
Csrn (Document) |
/{imsUeId}/access-data/ |
GET |
Retrieve a CSRN for the UE |
ReferenceAccessLocation (Document) |
/{imsUeId}/access-data/wireline-domain/reference-location |
GET |
Retrieve the UE’s subscribed Reference Access Location |
SRVCC Data (Document) |
/{imsUeId}/srvcc-data |
GET |
Retrieve the UE’s STN-SR and SRVCC capability |
PATCH |
Update the UE’s STN-SR. |
||
PSI Activation State (Document) |
/{imsUeId}/service-data/ |
GET |
Retrieve a PSI activation status |
PATCH |
Update a PSI activation status |
||
Dsai (Document) |
/{imsUeId}/service-data/dsai |
GET |
Retrieve DSAI data (i.e. DSAI tags and status) associated to an Application Server |
PATCH |
Update DSAI data associated to an Application Server |
||
SMSRegistrationInfo (Document) |
/{imsUeId}/service-data/ |
GET |
Retrieve the SMS Registration Information (e.g. IP-SM-GW address) |
PUT |
Creates or updates the SMS Registration Information (e.g. IP-SM-GW address) |
||
DELETE |
Deletes the SMS Registration Information (e.g. IP-SM-GW address) |
||
SharedData |
/shared-data |
GET |
Retrieve shared data |
SharedDataSubscriptions |
/shared-data-subscriptions |
POST |
Create a subscription |
Shared Data Individual Subscription |
/shared-data-subscriptions/{subscriptionId} |
DELETE |
Delete the subscription identified by {subscriptionId}, i.e. unsubscribe |
PATCH |
Modify the subscription identified by {subscriptionId} |
6.2.3.2 Resource: IMS Associated Identities
6.2.3.2.1 Description
This resource represents the IMS associated identities. It is queried by the service consumer (IMS-AS) to retrieve the list of identities in the same Implicit Registration Set, together with the Alias Group Information and additional information (e.g. identity type)
6.2.3.2.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/identities/ims-associated-identities
This resource shall support the resource URI variables defined in table 6.2.3.2.2-1.
Table 6.2.3.2.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.2.3 Resource Standard Methods
6.2.3.2.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.2.3.1-1.
Table 6.2.3.2.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.2.3.2.3.1-2 and the response data structures and response codes specified in table 6.2.3.2.3.1-3.
Table 6.2.3.2.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.2.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ImsAssociatedIdentities |
M |
1 |
200 OK |
A response body containing the list of identities belonging to the same Implicit Registration Set shall be returned, together with the related information (Alias Group, if any, identity type, IRS default identity, registration state of the IRS). |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – USER_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate one of the following application errors: – OPERATION_NOT_ALLOWED |
Table 6.2.3.2.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.2.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.3 Resource: MSISDNS
6.2.3.3.1 Description
This resource represents the MSISDNs associated to the UE. It is queried by the service consumer (IMS-AS) to retrieve the list of MSISDNs (basic and additional). If the UE is shared among multiple IMS Private Identities and the consumer queries for the basic MSISDN (C-MSISDN), the URI query parameter Private Identity (IMPI) shall be included.
6.2.3.3.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/identities/msisdns
This resource shall support the resource URI variables defined in table 6.2.3.3.2-1.
Table 6.2.3.3.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.3.3 Resource Standard Methods
6.2.3.3.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.3.3.1-1.
Table 6.2.3.3.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
private-id |
PrivateId |
O |
0..1 |
IMS Private Identity (IMPI) of the UE. It shall be included if there are multiple Private Identities associated to the Public Identity received and the basic MSISDN (C-MSISDN) is requested. |
This method shall support the request data structures specified in table 6.2.3.3.3.1-2 and the response data structures and response codes specified in table 6.2.3.3.3.1-3.
Table 6.2.3.3.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.3.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
MsisdnList |
M |
1 |
200 OK |
A response body containing the list of MSISDNs associated to the UE and all Private Identities shall be returned. If the response is for a basic MSISDN (C-MSISDN) query (query parameter IMPI was present), only one MSISDN shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.3.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.3.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.4 Resource: S-CSCF Capabilities
6.2.3.4.1 Description
This resource represents the S-CSCF capabilities. It is queried by the service consumer (I-CSCF) to retrieve S-CSCF capabilities associated to the UE (mandatory capabilities and/or optional capabilities).
6.2.3.4.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/location-data/scscf-capabilities
This resource shall support the resource URI variables defined in table 6.2.3.4.2-1.
Table 6.2.3.4.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.4.3 Resource Standard Methods
6.2.3.4.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.4.3.1-1.
Table 6.2.3.4.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.2.3.4.3.1-2 and the response data structures and response codes specified in table 6.2.3.4.3.1-3.
Table 6.2.3.4.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.4.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ScscfCapabilityList |
M |
1 |
200 OK |
A response body containing the list mandatory and/or optional capabilities shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND NOTE: DATA_NOT_FOUND indicates that any S-CSCF can be selected, e.g. based on I-CSCF local policy. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.4.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.4.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.5 Resource: IMS Profile Data
6.2.3.5.1 Description
This resource represents the IMS Profile Data. It is queried by the service consumer (S-CSCF) to retrieve the user’s IMS profile data, containing the required information to handle the multimedia sessions (e.g. Initial Filter Criteria)
6.2.3.5.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/profile-data
This resource shall support the resource URI variables defined in table 6.2.3.5.2-1.
Table 6.2.3.5.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.5.3 Resource Standard Methods
6.2.3.5.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.5.3.1-1.
NOTE: The retrieval of these data sets can also be achieved by sending individual GET requests to the corresponding sub-resources under the {imsUeId} resource. When multiple data sets need to be retrieved by the NF Service consumer, it is recommended to use a single GET request with query parameters rather than issuing multiple GET requests.
Table 6.2.3.5.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
dataset-names |
array(DataSetName) |
O |
1..N |
Datasets to be retrieved |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.5.3.1-2 and the response data structures and response codes specified in table 6.2.3.5.3.1-3.
Table 6.2.3.5.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.5.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ImsProfileData |
M |
1 |
200 OK |
Upon success, a response body containing the User’s Profile Data shall be included. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application errors: – OPERATION_NOT_ALLOWED |
Table 6.2.3.5.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.5.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.6 Resource: Subscriptions
6.2.3.6.1 Description
This resource is used to represent subscriptions to notifications of data change.
6.2.3.6.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/subscriptions
This resource shall support the resource URI variables defined in table 6.2.3.6.2-1.
Table 6.2.3.6.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.6.3 Resource Standard Methods
6.2.3.6.3.1 POST
This method shall support the URI query parameters specified in table 6.2.3.6.3.1-1.
Table 6.2.3.6.3.1-1: URI query parameters supported by the POST method on this resource
Name |
Data type |
P |
Cardinality |
Description |
n/a |
This method shall support the request data structures specified in table 6.2.3.6.3.1-2 and the response data structures and response codes specified in table 6.2.3.6.3.1-3.
Table 6.2.3.6.3.1-2: Data structures supported by the POST Request Body on this resource
Data type |
P |
Cardinality |
Description |
ImsSdmSubscription |
M |
1 |
The subscription that is to be created. |
Table 6.2.3.6.3.1-3: Data structures supported by the POST Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ImsSdmSubscription |
M |
1 |
201 Created |
Upon success, a response body containing a representation of the created Individual subscription resource shall be returned. The HTTP response shall include a "Location" HTTP header that contains the resource URI of the created resource. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – USER_NOT_FOUND |
ProblemDetails |
O |
0..1 |
501 Not Implemented |
The "cause" attribute may be used to indicate the following application error: – UNSUPPORTED_RESOURCE_URI This response shall not be cached. |
Table 6.2.3.6.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.6.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.7 Resource: Individual subscription
6.2.3.7.1 Description
This resource is used to represent an individual subscription to notifications of data change.
6.2.3.7.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/subscriptions/{subscriptionId}
This resource shall support the resource URI variables defined in table 6.2.3.7.2-1.
Table 6.2.3.7.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
subscriptionId |
The subscriptionId identifies an individual subscription to notifications. |
6.2.3.7.3 Resource Standard Methods
6.2.3.7.3.1 DELETE
This method shall support the URI query parameters specified in table 6.2.3.7.3.1-1.
Table 6.2.3.7.3.1-1: URI query parameters supported by the DELETE method on this resource
Name |
Data type |
P |
Cardinality |
Description |
n/a |
This method shall support the request data structures specified in table 6.2.3.7.3.1-2 and the response data structures and response codes specified in table 6.2.3.7.3.1-3.
Table 6.2.3.7.3.1-2: Data structures supported by the Delete Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
The request body shall be empty. |
Table 6.2.3.7.3.1-3: Data structures supported by the DELETE Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned. |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – SUBSCRIPTION_NOT_FOUND, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
Table 6.2.3.7.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.7.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.7.3.2 PATCH
This method shall support the URI query parameters specified in table 6.2.3.7.3.2-1.
Table 6.2.3.7.3.2-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.7.3.2-2 and the response data structures and response codes specified in table 6.2.3.7.3.2-3.
Table 6.2.3.7.3.2-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1 |
It contains the list of changes to be made to the resource representing the individual subscription, according to the JSON PATCH format specified in IETF RFC 6902 [12]. |
Table 6.2.3.7.3.2-3: Data structures supported by the PATCH Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, a response with no content is returned. (NOTE 1) |
||
PatchResult |
M |
1 |
200 OK |
Upon success, the execution report is returned. (NOTE 1) |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – SUBSCRIPTION_NOT_FOUND, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
One or more attributes are not allowed to be modified. The "cause" attribute may be used to indicate the following application error: – MODIFICATION_NOT_ALLOWED, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
NOTE 1: If all the modification instructions in the PATCH request have been implemented, the HSS shall respond with 204 No Content response; if some of the modification instructions in the PATCH request have been discarded, and the NF service consumer has included in the supported-feature query parameter the "PatchReport" feature number, the HSS shall respond with PatchResult. |
Table 6.2.3.7.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.7.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.8 Resource: SharedDataSubscriptions
6.2.3.8.1 Description
This resource is used to represent subscriptions to notifications for shared data.
6.2.3.8.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/shared-data-subscriptions
This resource shall support the resource URI variables defined in table 6.2.3.8.2-1.
Table 6.2.3.8.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
6.2.3.8.3 Resource Standard Methods
6.2.3.8.3.1 POST
This method shall support the URI query parameters specified in table 6.2.3.8.3.1-1.
Table 6.2.3.8.3.1-1: URI query parameters supported by the POST method on this resource
Name |
Data type |
P |
Cardinality |
Description |
n/a |
This method shall support the request data structures specified in table 6.2.3.8.3.1-2 and the response data structures and response codes specified in table 6.2.3.8.3.1-3.
Table 6.2.3.8.3.1-2: Data structures supported by the POST Request Body on this resource
Data type |
P |
Cardinality |
Description |
ImsSdmSubscription |
M |
1 |
The subscription that is to be created. |
Table 6.2.3.8.3.1-3: Data structures supported by the POST Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ImsSdmSubscription |
M |
1 |
201 Created |
Upon success, a response body containing a representation of the created Individual subscription resource shall be returned. The HTTP response shall include a "Location" HTTP header that contains the resource URI of the created resource. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
501 Not Implemented |
The "cause" attribute may be used to indicate the following application error: – UNSUPPORTED_RESOURCE_URI This response shall not be cached. |
Table 6.2.3.8.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.8.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.9 Resource: Shared Data Individual subscription
6.2.3.9.1 Description
This resource is used to represent an individual subscription to notifications for shared data.
6.2.3.9.2 Resource Definition
Resource URI: {apiRoot}/nhss-sdm/{apiVersion}/shared-data-subscriptions/{subscriptionId}
This resource shall support the resource URI variables defined in table 6.2.3.9.2-1.
Table 6.2.3.9.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
subscriptionId |
The subscriptionId identifies an individual subscription to notifications. |
6.2.3.9.3 Resource Standard Methods
6.2.3.9.3.1 DELETE
This method shall support the URI query parameters specified in table 6.2.3.9.3.1-1.
Table 6.2.3.9.3.1-1: URI query parameters supported by the DELETE method on this resource
Name |
Data type |
P |
Cardinality |
Description |
n/a |
This method shall support the request data structures specified in table 6.2.3.zz.3.1-2 and the response data structures and response codes specified in table 6.2.3.zz.3.1-3.
Table 6.2.3.9.3.1-2: Data structures supported by the Delete Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
The request body shall be empty. |
Table 6.2.3.9.3.1-3: Data structures supported by the DELETE Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned. |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The resource corresponding to the SubscriptionId can’t be found. The "cause" attribute may be used to indicate the following application error: – SUBSCRIPTION_NOT_FOUND, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
Table 6.2.3.9.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.9.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.9.3.2 PATCH
This method shall support the URI query parameters specified in table 6.2.3.9.3.2-1.
Table 6.2.3.9.3.2-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.9.3.2-2 and the response data structures and response codes specified in table 6.2.3.9.3.2-3.
Table 6.2.3.9.3.2-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1 |
It contains the list of changes to be made to the resource representing the individual subscription, according to the JSON PATCH format specified in IETF RFC 6902 [12]. |
Table 6.2.3.9.3.2-3: Data structures supported by the PATCH Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, a response with no content is returned. (NOTE 1) |
||
PatchResult |
M |
1 |
200 OK |
Upon success, the execution report is returned. (NOTE 1) |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The resource corresponding to the SubscriptionId can’t be found. The "cause" attribute may be used to indicate the following application error: – SUBSCRIPTION_NOT_FOUND, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
One or more attributes are not allowed to be modified. The "cause" attribute may be used to indicate the following application error: – MODIFICATION_NOT_ALLOWED, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
NOTE 1: If all the modification instructions in the PATCH request have been implemented, the HSS shall respond with 204 No Content response; if some of the modification instructions in the PATCH request have been discarded, and the NF service consumer has included in the supported-feature query parameter the "PatchReport" feature number, the HSS shall respond with PatchResult. |
Table 6.2.3.9.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.9.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.10 Resource: IMS Registration Status
6.2.3.10.1 Description
This resource represents the IMS Registration Status. It is queried by the service consumer (e.g. AS) to retrieve the IMS registration status of the user.
6.2.3.10.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/registration-status
This resource shall support the resource URI variables defined in table 6.2.3.10.2-1.
Table 6.2.3.10.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.10.3 Resource Standard Methods
6.2.3.10.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.10.3.1-1.
Table 6.2.3.10.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.10.3.1-2 and the response data structure and response codes specified in table 6.2.3.10.3.1-3.
Table 6.2.3.10.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.10.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ImsRegistrationStatus |
M |
1 |
200 OK |
A response body containing the IMS registration status of the user. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates the user has not performed yet any IMS registration. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.10.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.10.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.11 Resource: Service Priority Information
6.2.3.11.1 Description
This resource represents the Service Priority Levels. It is queried by the service consumer (e.g. AS) to retrieve the Namespaces and priority levels allowed for the user.
6.2.3.11.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/profile-data/priority-levels
This resource shall support the resource URI variables defined in table 6.2.3.11.2-1.
Table 6.2.3.11.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.11.3 Resource Standard Methods
6.2.3.11.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.11.3.1-1.
Table 6.2.3.11.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP 1 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.11.3.1-2 and the response data structures and response codes specified in table 6.2.3.11.3.1-3.
Table 6.2.3.11.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.11.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
PriorityLevels |
M |
1 |
200 OK |
A response body containing the service priority information (priority namespaces and associated levels) allowed for the user shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that the user does not have priority service. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.11.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.11.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.12 Resource: Initial Filter Criteria
6.2.3.12.1 Description
This resource represents the Initial Filter Criteria (IFCs). It is queried by the service consumer (e.g. S-CSCF, AS) to retrieve the list of IFCs associated to the UE (including Shared IFC Set Identifiers, if provisioned).
6.2.3.12.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/profile-data/ifcs
This resource shall support the resource URI variables defined in table 6.2.3.12.2-1.
Table 6.2.3.12.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.12.3 Resource Standard Methods
6.2.3.12.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.12.3.1-1.
Table 6.2.3.12.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
|
application-server-name |
SipServerName |
O |
0..1 |
This information element indicates application server’s SIP URI. |
This method shall support the request data structures specified in table 6.2.3.12.3.1-2 and the response data structures and response codes specified in table 6.2.3.12.3.1-3.
Table 6.2.3.12.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.12.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
Ifcs |
M |
1 |
200 OK |
A response body containing the list of complete IFCs and/or shared IFC set identifiers shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that there is no Initial Filter Criteria associated to the user (i.e. no AS is triggered by S-CSCF for the user) |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.12.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.12.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.13 Resource: IMS Location Data
6.2.3.13.1 Description
This resource represents the IMS location data. It is queried by the service consumer (e.g. AS) to retrieve the S-CSCF name stored for the user.
6.2.3.13.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/location-data/server-name
This resource shall support the resource URI variables defined in table 6.2.3.13.2-1.
Table 6.2.3.13.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.13.3 Resource Standard Methods
6.2.3.13.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.13.3.1-1.
Table 6.2.3.13.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.13.3.1-2 and the response data structure and response codes specified in table 6.2.3.13.3.1-3.
Table 6.2.3.13.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.13.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ImsLocationData |
M |
1 |
200 OK |
A response body containing the S-CSCF name stored for the user. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates the user has not performed yet any IMS registration. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.13.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.13.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.14 Resource: Service Level Trace Information
6.2.3.14.1 Description
This resource represents the Service Level Trace Information. It is queried by the service consumer (e.g. AS) to retrieve the Trace Level information so that the consumer can perform logging for the user as described in IETF RFC 8497 [23].
6.2.3.14.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/profile-data/service-trace-level-information
This resource shall support the resource URI variables defined in table 6.2.3.14.2-1.
Table 6.2.3.14.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.14.3 Resource Standard Methods
6.2.3.14.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.14.3.1-1.
Table 6.2.3.14.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.14.3.1-2 and the response data structures and response codes specified in table 6.2.3.14.3.1-3.
Table 6.2.3.14.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.14.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ServiceLevelTraceInformation |
M |
1 |
200 OK |
A response body containing the IMS service level trace information shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that the service level tracing is disabled for the user. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.14.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.14.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.15 Resource: PS location Information
6.2.3.15.1 Description
This resource represents the Location Information in PS domain. It is queried by the service consumer (e.g. AS) to retrieve the location information in PS domain as retrieved from the serving node(s). The service consumer may indicate the requested nodes for which the request is applicable (e.g. AMF only)
6.2.3.15.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/ps-domain/location-data
This resource shall support the resource URI variables defined in table 6.2.3.15.2-1.
Table 6.2.3.15.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) or the IMS private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.15.3 Resource Standard Methods
6.2.3.15.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.15.3.1-1.
Table 6.2.3.15.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
requested-nodes |
array(RequestedNode) |
O |
1..N |
Indicates the serving node(s) for which the request is applicable. |
serving-node |
boolean |
O |
0..1 |
Indicates that only the stored NF id/address of the serving node(s) requested and PLMN identity are required, that is, other location data (e.g. Global Cell ID) is not required. It shall be absent if current-location is present with value true. true: only the requested node(s) address(es) are requested false or absent: location data as retrieved from the requested node(s) is requested. |
local-time |
boolean |
O |
0..1 |
Indicates that only the Local Time Zone information (Time Zone and Daylight Saving Time) and the PLMN identity of the location in the visited network where the UE is attached is requested, that is, other location data (e.g. Global Cell ID) is not required. true: only the local time is requested false or absent: location data as retrieved from the requested node(s) is requested. |
current-location |
boolean |
O |
0..1 |
Indicates whether an active location retrieval has to be initiated by the requested node(s). true: active location retrieval is requested false or absent: active location retrieval is not requested |
rat-type |
boolean |
O |
0..1 |
Indicates whether retrieval of RAT type is requested. true: requested false: not requested |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
If "requested-nodes" is not included, HSS shall return location information as retrieved from all the nodes (AMF, MME and SGSN)
This method shall support the request data structures specified in table 6.2.3.15.3.1-2 and the response data structures and response codes specified in table 6.2.3.15.3.1-3.
Table 6.2.3.15.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.15.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
PsLocation |
M |
1 |
200 OK |
A response body containing the PS location information as requested shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that the location information is unknown or unavailable. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.15.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.15.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.16 Resource: CS location Information
6.2.3.16.1 Description
This resource represents the Location Information in CS domain. It is queried by the service consumer (e.g. AS) to retrieve the location information in CS domain as retrieved from the MSC/VLR.
6.2.3.16.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/cs-domain/location-data
This resource shall support the resource URI variables defined in table 6.2.3.16.2-1.
Table 6.2.3.16.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) or the IMS private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.16.3 Resource Standard Methods
6.2.3.16.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.16.3.1-1.
Table 6.2.3.16.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
serving-node |
boolean |
O |
0..1 |
Indicates that only the MSC/VLR address and PLMN identity are required, that is, other location data (e.g. Global Cell ID) is not required. It shall be absent if current-location is present. true: only the MSC/VLR number requested false or absent: location data as retrieved from the MSC/VLR is requested. |
local-time |
boolean |
O |
0..1 |
Indicates that only the Local Time Zone information (Time Zone and Daylight Saving Time) and the PLMN identity of the location in the visited network where the UE is attached is requested, that is, other location data (e.g. Global Cell ID) is not required. It shall be absent if current-location is present. |
current-location |
boolean |
O |
0..1 |
Indicates whether an active location retrieval has to be initiated by the MSC/VLR. |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
If "serving-node" is not included, HSS shall return the location data as retrieved from the MSC/VLR.
If "local-time" is not included, HSS shall return the location data as retrieved from the MSC/VLR.
This method shall support the request data structures specified in table 6.2.3.16.3.1-2 and the response data structures and response codes specified in table 6.2.3.16.3.1-3.
Table 6.2.3.16.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.16.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
CsLocation |
M |
1 |
200 OK |
A response body containing the CS location information as requested shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that the location information is unknown or unavailable. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.16.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.16.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.17 Resource: SRVCC data
6.2.3.17.1 Description
This resource represents the SRVCC data. It is queried by the service consumer (e.g. AS) to retrieve the UE SRVCC capability and the STN-SR for the user.
6.2.3.17.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/srvcc-data
This resource shall support the resource URI variables defined in table 6.2.3.17.2-1.
Table 6.2.3.17.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) or the IMS private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.17.3 Resource Standard Methods
6.2.3.17.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.17.3.1-1.
Table 6.2.3.17.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
|
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.17.3.1-2 and the response data structures and response codes specified in table 6.2.3.17.3.1-3.
Table 6.2.3.17.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.17.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
SrvccData |
M |
1 |
200 OK |
A response body containing the STN-SR and the UE SRVCC capabilities for the user shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that the user is not subscribed to SRVCC. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.17.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.17.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.17.3.2 PATCH
This method shall support the URI query parameters specified in table 6.2.3.17.3.2-1.
Table 6.2.3.17.3.2-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.17.3.2-2 and the response data structures and response codes specified in table 6.2.3.17.3.2-3.
Table 6.2.3.17.3.2-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1..N |
Items describe the modifications to the SRVCC data. Modification are not applicable to UE SRVCC capabilities. |
Table 6.2.3.17.3.2-3: Data structures supported by the PATCH Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned. (NOTE 1) |
||
PatchResult |
M |
1 |
200 OK |
Upon success, the execution report is returned. (NOTE 1) |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that the user is not subscribed to SRVCC. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
One or more attributes are not allowed to be modified. The "cause" attribute may be used to indicate one of the following application errors: – MODIFICATION_NOT_ALLOWED, see GPP TS 29.500 [4] table 5.2.7.2-1. – OPERATION_NOT_ALLOWED |
NOTE 1: If all the modification instructions in the PATCH request have been implemented, the HSS shall respond with 204 No Content response; if some of the modification instructions in the PATCH request have been discarded, and the NF service consumer has included in the supported-feature query parameter the "PatchReport" feature number, the HSS shall respond with PatchResult. |
Table 6.2.3.17.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.17.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.18 Resource: PSI activation state
6.2.3.18.1 Description
This resource represents the PSI activation state. It is queried by the service consumer (e.g. AS) to retrieve the activation state for the IMS Public Service Identity.
6.2.3.18.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/psi-status
This resource shall support the resource URI variables defined in table 6.2.3.18.2-1.
Table 6.2.3.18.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Service Identity pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.18.3 Resource Standard Methods
6.2.3.18.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.18.3.1-1.
Table 6.2.3.18.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.18.3.1-2 and the response data structures and response codes specified in table 6.2.3.18.3.1-3.
Table 6.2.3.18.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.18.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
PsiActivationState |
M |
1 |
200 OK |
A response body containing the PSI activation state shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – SERVICE_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.18.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.18.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.18.3.2 PATCH
This method shall support the URI query parameters specified in table 6.2.3.18.3.2-1.
Table 6.2.3.18.3.2-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.18.3.2-2 and the response data structures and response codes specified in table 6.2.3.18.3.2-3.
Table 6.2.3.18.3.2-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1..N |
Items describe the modifications to the PSI activation state. |
Table 6.2.3.18.3.2-3: Data structures supported by the PATCH Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned. (NOTE 1) |
||
PatchResult |
M |
1 |
200 OK |
Upon success, the execution report is returned. (NOTE 1) |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – SERVICE_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
One or more attributes are not allowed to be modified. The "cause" attribute may be used to indicate one of the following application errors: – MODIFICATION_NOT_ALLOWED, see GPP TS 29.500 [4] table 5.2.7.2-1. – OPERATION_NOT_ALLOWED |
NOTE 1: If all the modification instructions in the PATCH request have been implemented, the HSS shall respond with 204 No Content response; if some of the modification instructions in the PATCH request have been discarded, and the NF service consumer has included in the supported-feature query parameter the "PatchReport" feature number, the HSS shall respond with PatchResult. |
Table 6.2.3.18.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.18.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.19 Resource: Repository Data
6.2.3.19.1 Description
This resource represents the Repository Data. It is used by the service consumer (e.g. IMS-AS) to create, retrieve, update or delete the repository data for a given service indication.
6.2.3.19.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/repository-data/{serviceIndication}
This resource shall support the resource URI variables defined in table 6.2.3.19.2-1.
Table 6.2.3.19.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
serviceIndication |
Represents the identifier of a service related data. |
6.2.3.19.3 Resource Standard Methods
6.2.3.19.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.19.3.1-1.
Table 6.2.3.19.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.19.3.1-2 and the response data structures and response codes specified in table 6.2.3.19.3.1-3.
Table 6.2.3.19.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.19.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
RepositoryData |
M |
1 |
200 OK |
A response body containing the Repository Data for the requested Service Indication. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.19.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.19.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.19.3.2 PUT
This method shall support the URI query parameters specified in table 6.2.3.19.3.2-1.
Table 6.2.3.19.3.2-1: URI query parameters supported by the PUT method on this resource
Name |
Data type |
P |
Cardinality |
Description |
n/a |
This method shall support the request data structures specified in table 6.2.3.19.3.2-2 and the response data structures and response codes specified in table 6.2.3.19.3.2-3.
Table 6.2.3.19.3.2-2: Data structures supported by the PUT Request Body on this resource
Data type |
P |
Cardinality |
Description |
RepositoryData |
M |
1 |
The Repository Data to be created or replaced. |
Table 6.2.3.19.3.2-3: Data structures supported by the PUT Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
RepositoryData |
M |
1 |
201 Created |
Upon success, a response body containing a representation of the created Individual RepositoryData resource shall be returned. |
RepositoryData |
M |
1 |
200 OK |
Upon success, a response body containing a representation of the updated Individual RepositoryData resource shall be returned. |
n/a |
204 No Content |
Upon success, an empty response body shall be returned |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – USER_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
ProblemDetails |
O |
0..1 |
409 Conflict |
The "cause" attribute may be used to indicate the following application error: – OUT_OF_SYNC |
ProblemDetails |
O |
0..1 |
413 Payload Too Large |
The "cause" attribute may be used to indicate the following application error: – TOO_MUCH_DATA |
Table 6.2.3.19.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.19.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.19.3.3 DELETE
This method shall support the URI query parameters specified in table 6.2.3.19.3.3-1.
Table 6.2.3.19.3.3-1: URI query parameters supported by the DELETE method on this resource
Name |
Data type |
P |
Cardinality |
Description |
n/a |
This method shall support the request data structures specified in table 6.2.3.19.3.3-2 and the response data structures and response codes specified in table 6.2.3.19.3.3-3.
Table 6.2.3.19.3.3-2: Data structures supported by the DELETE Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
The request body shall be empty. |
Table 6.2.3.19.3.3-3: Data structures supported by the DELETE Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that no repository data exists for the requested service indication. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.19.3.3-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.19.3.3-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.20 Resource: SharedData
6.2.3.20.1 Description
This resource represents the collection of data that can be shared by multiple UEs.
6.2.3.20.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/<apiVersion>/shared-data
This resource shall support the resource URI variables defined in table 6.2.3.20.2-1.
Table 6.2.3.20.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
6.2.3.20.3 Resource Standard Methods
6.2.3.20.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.20.3.1-1.
Table 6.2.3.20.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
shared-data-ids |
array(SharedDataId) |
M |
1..N |
This method shall support the request data structures specified in table 6.2.3.20.3.1-2 and the response data structures and response codes specified in table 6.2.3.20.3.1-3.
Table 6.2.3.20.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.20.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
array(SharedData) |
M |
1..N |
200 OK |
Upon success, a response body containing a list of SharedData shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – DATA_NOT_FOUND |
Table 6.2.3.20.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.20.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.21 Resource: ImeiSvInformation
6.2.3.21.1 Description
This resource represents the IMEI(SV) information. It is queried by the service consumer (e.g. IMS AS) to retrieve the IMEI(SV) for the user.
6.2.3.21.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/identities/imeisv
This resource shall support the resource URI variables defined in table 6.2.3.21.2-1.
Table 6.2.3.21.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity) or the IMS Private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.21.3 Resource Standard Methods
6.2.3.21.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.21.3.1-1.
Table 6.2.3.21.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
|
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.21.3.1-2 and the response data structures and response codes specified in table 6.2.3.21.3.1-3.
Table 6.2.3.21.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.21.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ImeiSvInformation |
M |
1 |
200 OK |
A response body containing the IMEI(SV) information for the user shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.21.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.21.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.22 Resource: IP Address
6.2.3.22.1 Description
This resource represents the IP Address Information. It is queried by the service consumer (e.g. SCC-AS) to retrieve the IP Address Information for the user.
6.2.3.22.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/ps-domain/ip-address
This resource shall support the resource URI variables defined in table 6.2.3.22.2-1.
Table 6.2.3.22.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. non-shared IMS Public User identity) or the IMS Private Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.22.3 Resource Standard Methods
6.2.3.22.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.22.3.1-1.
Table 6.2.3.22.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.22.3.1-2 and the response data structures and response codes specified in table 6.2.3.22.3.1-3.
Table 6.2.3.22.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.22.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
IpAddr |
M |
1 |
200 OK |
A response body containing the IP address (IPv4, Ipv6, Ipv6 prefix and/or IPv6 interface identifier) for the user shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that no IP Address is currently allocated for the user. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.22.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.22.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.23 Resource: T-ADS Info
6.2.3.23.1 Description
This resource represents the T-ADS Information. It is queried by the service consumer (e.g. SCC-AS) to retrieve the T-ADS Information for the user.
6.2.3.23.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/ps-domain/tads-info
This resource shall support the resource URI variables defined in table 6.2.3.23.2-1.
Table 6.2.3.23.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity) or the IMS Private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.23.3 Resource Standard Methods
6.2.3.23.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.23.3.1-1.
Table 6.2.3.23.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
|
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.23.3.1-2 and the response data structures and response codes specified in table 6.2.3.23.3.1-3.
Table 6.2.3.23.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.23.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
TadsInformation |
M |
1 |
200 OK |
A response body containing the T-ADS information (most recent VoPS support) for the user shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.23.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.23.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.24 Resource: UeReachabilitySubscriptions
6.2.3.24 Description
This resource is used to represent subscriptions to notifications of UE Reachability for IP.
6.2.3.24.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/ps-domain/ue-reach-subscriptions
This resource shall support the resource URI variables defined in table 6.2.3.24.2-1.
Table 6.2.3.24.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.24.3 Resource Standard Methods
6.2.3.24.3.1 POST
This method shall support the URI query parameters specified in table 6.2.3.24.3.1-1.
Table 6.2.3.24.3.1-1: URI query parameters supported by the POST method on this resource
Name |
Data type |
P |
Cardinality |
Description |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.24.3.1-2 and the response data structures and response codes specified in table 6.2.3.24.3.1-3.
Table 6.2.3.24.3.1-2: Data structures supported by the POST Request Body on this resource
Data type |
P |
Cardinality |
Description |
UeReachabilitySubscription |
M |
1 |
The subscription to UE reachability for IP that is to be created. |
Table 6.2.3.24.3.1-3: Data structures supported by the POST Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
CreatedUeReachabilitySubscription |
M |
1 |
201 Created |
Upon success, a response body containing a representation of the created Individual subscription resource shall be returned. The HTTP response shall include a "Location" HTTP header that contains the resource URI of the created resource. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – USER_NOT_FOUND |
Table 6.2.3.24.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.24.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.25 Resource: UE reachability Individual subscription
6.2.3.25.1 Description
This resource is used to represent an individual subscription to notification of UE reachability for IP.
6.2.3.25.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/ps-domain/ue-reach-subscriptions/{subscriptionId}
This resource shall support the resource URI variables defined in table 6.2.3.25.2-1.
Table 6.2.3.25.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
subscriptionId |
The subscriptionId identifies an individual subscription to notification of UE reachability for IP. |
6.2.3.25.3 Resource Standard Methods
6.2.3.25.3.1 DELETE
This method shall support the URI query parameters specified in table 6.2.3.25.3.1-1.
Table 6.2.3.25.3.1-1: URI query parameters supported by the DELETE method on this resource
Name |
Data type |
P |
Cardinality |
Description |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.7.3.1-2 and the response data structures and response codes specified in table 6.2.3.7.3.1-3.
Table 6.2.3.25.3.1-2: Data structures supported by the Delete Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
The request body shall be empty. |
Table 6.2.3.25.3.1-3: Data structures supported by the DELETE Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned. |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – SUBSCRIPTION_NOT_FOUND, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
Table 6.2.3.25.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.25.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.25.3.2 PATCH
This method shall support the URI query parameters specified in table 6.2.3.25.3.2-1.
Table 6.2.3.25.3.2-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.25.3.2-2 and the response data structures and response codes specified in table 6.2.3.25.3.2-3.
Table 6.2.3.25.3.2-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1 |
It contains the list of changes to be made to the resource representing the individual subscription, according to the JSON PATCH format specified in IETF RFC 6902 [12]. |
Table 6.2.3.25.3.2-3: Data structures supported by the PATCH Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, a response with no content is returned. (NOTE 1) |
||
PatchResult |
M |
1 |
200 OK |
Upon success, the execution report is returned. (NOTE 1) |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – SUBSCRIPTION_NOT_FOUND, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
One or more attributes are not allowed to be modified. The "cause" attribute may be used to indicate the following application error: – MODIFICATION_NOT_ALLOWED, see 3GPP TS 29.500 [4] table 5.2.7.2-1. |
NOTE 1: If all the modification instructions in the PATCH request have been implemented, the HSS shall respond with 204 No Content response; if some of the modification instructions in the PATCH request have been discarded, and the NF service consumer has included in the supported-feature query parameter the "PatchReport" feature number, the HSS shall respond with PatchResult. |
Table 6.2.3.25.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.25.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.26 Resource: PS User State
6.2.3.26.1 Description
This resource represents the User State information in PS domain. It is queried by the service consumer (e.g. AS) to retrieve the User State information in PS domain as retrieved from the serving node(s). The service consumer may indicate the requested nodes for which the request is applicable (e.g. AMF only)
6.2.3.26.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/ps-domain/user-state
This resource shall support the resource URI variables defined in table 6.2.3.26.2-1.
Table 6.2.3.26.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) or the IMS private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.26.3 Resource Standard Methods
6.2.3.26.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.26.3.1-1.
Table 6.2.3.26.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
requested-nodes |
array(RequestedNode) |
O |
1..N |
Indicates the serving node(s) for which the request is applicable. |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
If "requested-nodes" is not included, HSS shall return the user state as retrieved from all the nodes (AMF, MME and SGSN)
This method shall support the request data structures specified in table 6.2.3.26.3.1-2 and the response data structures and response codes specified in table 6.2.3.26.3.1-3.
Table 6.2.3.26.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.26.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
PsUserState |
M |
1 |
200 OK |
A response body containing the PS user state information as requested shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that the user state information is unknown or unavailable. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.26.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.26.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.27 Resource: CS User State
6.2.3.27.1 Description
This resource represents the User State information in CS domain. It is queried by the service consumer (e.g. AS) to retrieve the User State information in CS domain as retrieved from the MSC/VLR.
6.2.3.27.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/cs-domain/user-state
This resource shall support the resource URI variables defined in table 6.2.3.27.2-1.
Table 6.2.3.27.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) or the IMS private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.27.3 Resource Standard Methods
6.2.3.27.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.27.3.1-1.
Table 6.2.3.27.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.27.3.1-2 and the response data structures and response codes specified in table 6.2.3.27.3.1-3.
Table 6.2.3.27.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.27.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
CsUserState |
M |
1 |
200 OK |
A response body containing the CS user state information as requested shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.27.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.27.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.28 Resource: Csrn
6.2.3.28.1 Description
This resource represents the CSRN. It is queried by the service consumer (e.g. SCC-AS) to retrieve a CSRN for the user.
6.2.3.28.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/cs-domain/csrn
This resource shall support the resource URI variables defined in table 6.2.3.28.2-1.
Table 6.2.3.28.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity) or the IMS Private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.28.3 Resource Standard Methods
6.2.3.28.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.28.3.1-1.
Table 6.2.3.28.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
|
pre-paging |
PrePaging |
O |
0..1 |
Indicates if pre-paging is supported true: pre-paging is supported false or absent: pre-paging is not supported |
|
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
|
call-reference-info |
CallReferenceInfo |
O |
0..1 |
Contains a Call Reference Number and the AS-Number. It allows a later retry of the call setup in the context of MTRR. See 3GPP TS 29.328 [38] |
This method shall support the request data structures specified in table 6.2.3.28.3.1-2 and the response data structures and response codes specified in table 6.2.3.28.3.1-3.
Table 6.2.3.28.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.28.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
Csrn |
M |
1 |
200 OK |
A response body containing the CSRN for the user shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that CSRN retrieval from MSC/VLR failed. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.28.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.28.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.29 Resource: ReferenceAccessLocation
6.2.3.29.1 Description
This resource represents the Reference Location Information. It is queried by the service consumer (e.g. IMS-AS) to retrieve the reference location information for the user (e.g. line identifier in fixed access networks).
6.2.3.29.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/access-data/wireline-domain/reference-location
This resource shall support the resource URI variables defined in table 6.2.3.29.2-1.
Table 6.2.3.29.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity) or the IMS Private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.29.3 Resource Standard Methods
6.2.3.29.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.29.3.1-1.
Table 6.2.3.29.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
|
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.29.3.1-2 and the response data structures and response codes specified in table 6.2.3.29.3.1-3.
Table 6.2.3.29.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.29.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ReferenceLocationInformation |
M |
1 |
200 OK |
A response body containing the reference location information (e.g. access type, line identifier) for the user shall be returned. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that no reference location information exist for the user. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.29.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.29.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.30 Resource: SMSRegistrationInfo
6.2.3.30.1 Description
This resource represents the SMS registration information. It is used by the service consumer (e.g. IP-SM-GW) to create, retrieve, update or delete the SMS registration information.
6.2.3.30.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/service-data/sms-registration-info
This resource shall support the resource URI variables defined in table 6.2.3.30.2-1.
Table 6.2.3.30.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity) or the IMS private Identity. If both the IMS Public Identity and the IMS Private Identity are available at the service consumer, the imsUeId represents the IMS Public Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.30.3 Resource Standard Methods
6.2.3.30.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.30.3.1-1.
Table 6.2.3.30.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.30.3.1-2 and the response data structures and response codes specified in table 6.2.3.30.3.1-3.
Table 6.2.3.30.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.30.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
SmsRegistrationInfo |
M |
1 |
200 OK |
A response body containing the SMS registration information. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that no IP-SM-GW number is preconfigured or created previously for the user. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate one of the following application errors: – OPERATION_NOT_ALLOWED |
Table 6.2.3.30.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.30.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.30.3.2 PUT
This method shall support the URI query parameters specified in table 6.2.3.30.3.2-1.
Table 6.2.3.30.3.2-1: URI query parameters supported by the PUT method on this resource
Name |
Data type |
P |
Cardinality |
Description |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.30.3.2-2 and the response data structures and response codes specified in table 6.2.3.30.3.2-3.
Table 6.2.3.30.3.2-2: Data structures supported by the PUT Request Body on this resource
Data type |
P |
Cardinality |
Description |
IpSmGwAddress |
M |
1 |
The SMS Registration Information to be created or replaced. |
Table 6.2.3.30.3.2-3: Data structures supported by the PUT Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
SmsRegistrationInfo |
M |
1 |
201 Created |
Upon success, a response body containing a representation of the created Individual RepositoryData resource shall be returned. |
SmsRegistrationInfo |
M |
1 |
200 OK |
Upon success, a response body containing a representation of the updated Individual RepositoryData resource shall be returned. |
n/a |
204 No Content |
Upon success, an empty response body shall be returned |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – USER_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
ProblemDetails |
O |
0..1 |
409 Conflict |
The "cause" attribute may be used to indicate the following application error: – IP_SM_GW_CANNOT_BE_MODIFIED |
Table 6.2.3.30.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.30.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.30.3.3 DELETE
This method shall support the URI query parameters specified in table 6.2.3.30.3.3-1.
Table 6.2.3.30.3.3-1: URI query parameters supported by the DELETE method on this resource
Name |
Data type |
P |
Cardinality |
Description |
private-identity |
PrivateId |
C |
0..1 |
Represents the IMS Private Identity. |
This method shall support the request data structures specified in table 6.2.3.30.3.3-2 and the response data structures and response codes specified in table 6.2.3.30.3.3-3.
Table 6.2.3.30.3.3-2: Data structures supported by the DELETE Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
The request body shall be empty. |
Table 6.2.3.30.3.3-3: Data structures supported by the DELETE Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that no SMS registration information exists for the user. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
ProblemDetails |
O |
0..1 |
409 Conflict |
The "cause" attribute may be used to indicate the following application error: – IP_SM_GW_CANNOT_BE_MODIFIED |
Table 6.2.3.30.3.3-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.30.3.3-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.31 Resource: Dsai
6.2.3.31.1 Description
This resource represents the DSAI Tag Information for the requested Application Server Name. It is used by the service consumer (e.g. IMS-AS) to retrieve or update the DSAI Tag Status.
6.2.3.31.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/service-data/dsai
This resource shall support the resource URI variables defined in table 6.2.3.31.2-1.
Table 6.2.3.31.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. non-shared IMS Public User identity) or the IMS private Identity. pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.31.3 Resource Standard Methods
6.2.3.31.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.31.3.1-1.
Table 6.2.3.31.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
application-server-name |
SipServerName |
M |
1 |
The requested Application Server Name. |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
dsai-tag |
string |
O |
0..1 |
This information element identify the requested instance of Dynamic Service Activation Info (DSAI). |
This method shall support the request data structures specified in table 6.2.3.31.3.1-2 and the response data structures and response codes specified in table 6.2.3.31.3.1-3.
Table 6.2.3.31.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.31.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
DsaiTagInformation |
M |
1 |
200 OK |
A response body containing the DSAI information for the requested Application Server. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND DATA_NOT_FOUND indicates that no DSAI Tag was found for the requested Application Server. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.31.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.31.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.31.3.2 PATCH
This method shall support the URI query parameters specified in table 6.2.3.31.3.2-1.
Table 6.2.3.31.3.2-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.31.3.2-2 and the response data structures and response codes specified in table 6.2.3.31.3.2-3.
Table 6.2.3.31.3.2-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1..N |
Items describe the modifications to the DSAI tag(s) activation state. |
Table 6.2.3.31.3.2-3: Data structures supported by the PATCH Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Upon success, an empty response body shall be returned. (NOTE 1) |
||
PatchResult |
M |
1 |
200 OK |
Upon success, the execution report is returned. (NOTE 1) |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – DSAI_TAG_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
One or more attributes are not allowed to be modified. The "cause" attribute may be used to indicate one of the following application errors: – MODIFICATION_NOT_ALLOWED, see GPP TS 29.500 [4] table 5.2.7.2-1. – OPERATION_NOT_ALLOWED |
NOTE 1: If all the modification instructions in the PATCH request have been implemented, the HSS shall respond with 204 No Content response; if some of the modification instructions in the PATCH request have been discarded, and the NF service consumer has included in the supported-feature query parameter the "PatchReport" feature number, the HSS shall respond with PatchResult. |
Table 6.2.3.31.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.31.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.32 Resource: Private Identities
6.2.3.32.1 Description
This resource represents the private identities. It is queried by the service consumer (IMS-AS) to retrieve the list of private identities.
6.2.3.32.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/identities/private-identities
This resource shall support the resource URI variables defined in table 6.2.3.32.2-1.
Table 6.2.3.32.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.32.3 Resource Standard Methods
6.2.3.32.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.32.3.1-1.
Table 6.2.3.32.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
|
impi |
PrivateId |
O |
0..1 |
Private Identity of type IMPI |
This method shall support the request data structures specified in table 6.2.3.32.3.1-2 and the response data structures and response codes specified in table 6.2.3.32.3.1-3.
Table 6.2.3.32.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.32.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
PrivateIdentities |
M |
1 |
200 OK |
A response body containing the list of private identities belonging to the IMS UE. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate the following application error: – USER_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.32.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.32.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.33 Resource: S-CSCF Selection Assistance Information
6.2.3.33.1 Description
This resource represents the S-CSCF selection assistance information. It is queried by the service consumer (I-CSCF) before S-CSCF selection.
6.2.3.33.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/location-data/scscf-selection-assistance-info
This resource shall support the resource URI variables defined in table 6.2.3.33.2-1.
Table 6.2.3.33.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.33.3 Resource Standard Methods
6.2.3.33.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.33.3.1-1.
Table 6.2.3.33.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.2.3.33.3.1-2 and the response data structures and response codes specified in table 6.2.3.33.3.1-3.
Table 6.2.3.33.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.33.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ScscfSelectionAssistanceInformation |
M |
1 |
200 OK |
A response body containing the S-CSCF Selection Assistance Information. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND NOTE: DATA_NOT_FOUND indicates that any S-CSCF can be selected, e.g. based on I-CSCF local policy. |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.33.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.33.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
6.2.3.34 Resource: Charging Information
6.2.3.34.1 Description
This resource represents the Charging Information. It is queried by the service consumer (e.g. AS) to retrieve the Diameter addresses Charging Functions for the user.
6.2.3.34.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/ims-data/profile-data/charging-info
This resource shall support the resource URI variables defined in table 6.2.3.34.2-1.
Table 6.2.3.34.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.34.3 Resource Standard Methods
6.2.3.34.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.34.3.1-1.
Table 6.2.3.34.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP 1 29.500 [4] clause 6.6 |
This method shall support the request data structures specified in table 6.2.3.34.3.1-2 and the response data structures and response codes specified in table 6.2.3.34.3.1-3.
Table 6.2.3.34.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.34.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
ChargingInfo |
M |
1 |
200 OK |
A response body containing the Charging Information for the user shall be returned. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
6.2.3.35 Resource: Repository Data List
6.2.3.35.1 Description
This resource represents the Repository Data. It is used by the service consumer (e.g. IMS-AS) to retrieve multiple repository data for a given list of service indications.
6.2.3.35.2 Resource Definition
Resource URI: {apiRoot}/nhss-ims-sdm/{apiVersion}/{imsUeId}/repository-data
This resource shall support the resource URI variables defined in table 6.2.3.19.2-1.
Table 6.2.3.35.2-1: Resource URI variables for this resource
Name |
Definition |
apiRoot |
See clause 6.2.1 |
apiVersion |
See clause 6.2.1 |
imsUeId |
Represents the IMS Public Identity (i.e. IMS Public User identity or Public Service Identity) pattern: "^(impu-sip\:([a-zA-Z0-9_\-.!~*()&=+$,;?\/]+)\@([A-Za-z0-9]+([-A-Za-z0-9]+)\.)+[a-z]{2,}|impu-tel\:\+[0-9]{5,15}|impi-.+|.+)$" |
6.2.3.35.3 Resource Standard Methods
6.2.3.35.3.1 GET
This method shall support the URI query parameters specified in table 6.2.3.35.3.1-1.
Table 6.2.3.35.3.1-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
supported-features |
SupportedFeatures |
O |
0..1 |
see 3GPP TS 29.500 [4] clause 6.6 |
service-indications |
array(ServiceIndication) |
M |
1..N |
This method shall support the request data structures specified in table 6.2.3.35.3.1-2 and the response data structures and response codes specified in table 6.2.3.35.3.1-3.
Table 6.2.3.35.3.1-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.2.3.35.3.1-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
RepositoryDataList |
M |
1 |
200 OK |
A response body containing the Repository Data List for the requested Service Indications. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI. The URI shall be an alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
ProblemDetails |
O |
0..1 |
404 Not Found |
The "cause" attribute may be used to indicate one of the following application errors: – USER_NOT_FOUND – DATA_NOT_FOUND |
ProblemDetails |
O |
0..1 |
403 Forbidden |
The "cause" attribute may be used to indicate the following application error: – OPERATION_NOT_ALLOWED |
Table 6.2.3.35.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |
Table 6.2.3.35.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same HSS (service) set. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected. |