5.2.16 Resource: SdmSubscriptions

29.5053GPP5G SystemRelease 18Stage 3TSUsage of the Unified Data Repository services for Subscription Data

5.2.16.1 Description

This resource represents the collection of SDM Subscriptions for a UE.

This resource is modelled with the Collection resource archetype (see clause C.1 of 3GPP TS 29.501 [7]).

5.2.16.2 Resource Definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/subscription-data/{ueId}/context-data/sdm-subscriptions

This resource shall support the resource URI variables defined in table 5.2.16.2-1.

Table 5.2.16.2-1: Resource URI variables for this resource

Name	Definition
apiRoot	See 3GPP TS 29.504 [2] clause 6.1.1
ueId	Represents the Subscription Identifier SUPI or GPSI (see 3GPP TS 23.501 [4] clause 5.9.2) pattern: See pattern of type VarUeId 3GPP TS 29.571 [3]

5.2.16.3 Resource Standard Methods

5.2.16.3.1 GET

This method shall support the URI query parameters specified in table 5.2.16.3.1-1.

Table 5.2.16.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 [8] clause 6.6

This method shall support the request data structures specified in table 5.2.16.3.1-2 and the response data structures and response codes specified in table 5.2.16.3.1-3.

Table 5.2.16.3.1-2: Data structures supported by the GET Request Body on this resource

Data type	P	Cardinality	Description
n/a

Table 5.2.16.3.1-3: Data structures supported by the GET Response Body on this resource

Data type	P	Cardinality	Response codes	Description
array(SdmSubscription)	M	1..N	200 OK	Upon success, a response body containing the individual SDM subscriptions shall be returned.
NOTE: In addition common data structures as listed in table 5.5-1 are supported.

5.2.16.3.2 POST

This method shall support the URI query parameters specified in table 5.2.16.3.2-1.

Table 5.2.16.3.2-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 5.2.16.3.1-2 and the response data structures and response codes specified in table 5.2.16.3.1-3.

Table 5.2.16.3.2-2: Data structures supported by the POST Request Body on this resource

Data type	P	Cardinality	Description
SdmSubscription	M	1	Identifies the subscriber data subscription to be stored in the UDR.

If the uniqueSubscription attribute is set to true in the sdmSubscription object, the UDR shall only allow one UE based sdmSubscription per UE per NF service consumer identified by the ueId in URI and NfInstanceId in SdmSubscription, and if additional filter criteria (e.g. dnn and/or singleNssai) are present in the sdmSubscription, per filter criteria (see 3GPP TS 29.503 [6], clause 5.2.2.3.2).

If the UDR detects that a subscription for the criteria already exist in the UDR, the UDR shall replace the old SdmSubscription with the new one.

Table 5.2.16.3.2-3: Data structures supported by the POST Response Body on this resource

Data type	P	Cardinality	Response codes	Description
SdmSubscription	M	1	201 Created	Upon success, a response body containing a representation of the UeId’s Individual subscription resource shall be returned. The HTTP response shall include a "Location" HTTP header that contains the resource URI of the created resource.
NOTE: In addition common data structures as listed in table 5.5-1 are supported.