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
(Archetype)

Resource URI

HTTP method or custom operation

Description

Repository Data
(Document)

/{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
(Document)

/{imsUeId}/identities/ims-associated-identities

GET

Retrieve the UE’s IMS associated identities (implicit and alias)

MSISDNs
(Document)

/{imsUeId}/identities/msisdns

GET

Retrieve the UE’s MSISDNs (basic and additional)

PrivateIdentities
(Document)

/{imsUeId}/identities/private-identities

GET

Retrieve the UE’s Private Identities (IMPI and IMSI)

ImeiSvInformation
(Document)

/{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
(Document)

/{imsUeId}/ims-data/
profile-data/ifcs

GET

Retrieve the UE’s subscribed Initial Filter Criteria

Service Level Trace Information
(Document)

/{imsUeId}/ims-data/profile-data/service-level-trace-info

GET

Retrieve the UE’s subscribed Service Level Trace Information

Service Priority Information
(Document)

/{imsUeId}/ims-data/
profile-data/priority-levels

GET

Retrieve the UE’s subscribed Service Priority Levels

Charging Information
(Document)

/{imsUeId}/ims-data/
profile-data/chargingInfo

GET

Retrieve the UE’s subscribed Charging Information

IMS Location Data
(Document)

/{imsUeId}/ims-data/location-data/server-name

GET

Retrieve the UE’s S-CSCF name

S-CSCF Capabilities
(Document)

/{imsUeId}/ims-data/location-data/scscf-capabilities

GET

Retrieve the UE’s S-CSCF capabilities (mandatory and/or optional)

S-CSCF Selection Assistance Information
(Document)

/{imsUeId}/ims-data/location-data/scscf-selection-assistance-info

GET

Retrieve the UE’s S-CSCF Selection Assistance Information

IMS Registration Status
(Document)

/{imsUeId}/ims-data/
registration-status

GET

Retrieve the UE’s IMS registration status.

Subscriptions
(Collection)

/{imsUeId}/subscriptions

POST

Create a subscription

Individual subscription
(Document)

/{imsUeId}/subscriptions/
{subscriptionId}

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/
ps-domain/location-data

GET

Retrieve the UE’s location in PS domain

CS Location Information(Document)

/{imsUeId}/access-data/
cs-domain/location-data

GET

Retrieve the UE’s location in CS domain

PsUserState
(Document)

/{imsUeId}/access-data/
ps-domain/user-state

GET

Retrieve the UE’s state in PS domain

CsUserState
(Document)

/{imsUeId}/access-data/
cs-domain/user-state

GET

Retrieve the UE’s state in CS domain

TadsInfo
(Document)

/{imsUeId}/access-data/
ps-domain/tads-info

GET

Retrieve the UE’s T-ADS information

UeReachabilityIpSubscriptions
(Collection)

/{imsUeId}/access-data/
ps-domain/ue-reach-subscriptions

POST

Create a subscription to UE Reachability for IP

UE reachability individual subscription
(Document)

/{imsUeId}/access-data/
ps-domain/ue-reach-subscriptions/
{subscriptionId}

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
(Document)

/{imsUeId}/access-data/
ps-domain/ip-address

GET

Retrieve the UE’s stored IP Address Secure Binding Information

Csrn

(Document)

/{imsUeId}/access-data/
cs-domain/csrn

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/
psi-status

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/
sms-registration-info

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
(Collection)

/shared-data

GET

Retrieve shared data

SharedDataSubscriptions
(Collection)

/shared-data-subscriptions

POST

Create a subscription

Shared Data Individual Subscription
(Document)

/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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.
Shall be present if the imsUeId variable in the resource URI takes the value of an IMS Public User Identity that is shared by several Private User Identities.

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.