5 Usage of Nudr_DataRepository Service API for Policy Data

29.5193GPP5G SystemRelease 18Stage 3TSUsage of the Unified Data Repository Service for Policy Data, Application Data and Structured Data for Exposure

5.1 Introduction

The following clauses specify the usage of Nudr_DataRepository service for policy data. The principles specified in 3GPP TS 29.504 [6] are followed unless explicitly specified otherwise in the following clauses.

5.2 Resources

5.2.1 Overview

This clause specifies the resources for the usage of the Unified Data Repository service for Policy Data.

5.2.2 Resource Structure

This clause describes the structure for the Resource URIs and the resources and methods used for the service.

Figure 5.2.2-1 depicts the resource URIs structure for the Nudr_DataRepository API for policy data.

Figure 5.2.2-1: Resource URI structure of the Nudr_DataRepository API for policy data

Table 5.2.2-1 provides an overview of the resources and applicable HTTP methods.

Table 5.2.2-1: Resources and methods overview

Resource name

Resource URI

HTTP method or custom operation

Description

PolicyDataForIndividualUe

/policy-data/ues/{ueId}

GET

Retrieve multiple policy data sets (access and mobility policy data, UE policy set data, session management policy data, usage monitoring data, operator specific policy data) for a subscriber.

AccessAndMobilityPolicyData

/policy-data/ues/{ueId}/
am-data

GET

Retrieve the access and mobility policy data for a subscriber.

UEPolicySet

/policy-data/ues/{ueId}/
ue-policy-set

GET

Retrieve the UE policy set data for a subscriber.

PUT

Create or modify the UE policy set data for a subscriber.

PATCH

Modify the UE policy set data for a subscriber.

SessionManagementPolicyData

/policy-data/ues/{ueId}/
sm-data

GET

Retrieve the session management policy data for a subscriber.

PATCH

When the feature "SessionManagementPolicyDataPatch" is supported, modify the session management policy data for a subscriber.

UsageMonitoringInformation

/policy-data/ues/{ueId}/
sm-data/{usageMonId}

GET

Retrieve a usage monitoring resource.

PUT

Create a usage monitoring resource.

DELETE

Delete a usage monitoring resource.

OperatorSpecificData

/policy-data/ues/{ueId}/
operator-specific-data

GET

Retrieve the operator specific policy data of a UE

PATCH

Modify the operator specific policy data of a UE.

PUT

Create or modify the operator specific policy data of a UE.

DELETE

Delete the operator specific policy data for a UE.

SponsorConnectivityData

/policy-data/sponsor-connectivity-data/{sponsorId}

GET

Retrieve the sponsored connectivity information for a given sponsorId.

BdtData

/policy-data/bdt-data

GET

Retrieve the BDT data collection.

IndividualBdtData

/policy-data/bdt-data/
{bdtReferenceId}

GET

Retrieve the BDT data information associated with a BDT reference Id.

PUT

Create a BDT data resource associated with a BDT reference Id.

PATCH

Modifies an BDT data resource associated with an BDT reference Id.

DELETE

Delete a BDT data resource associated with a BDT reference Id.

PolicyDataSubscriptions

/policy-data/subs-to-notify

POST

Create a subscription to receive notifications of policy data changes.

IndividualPolicyDataSubscription

/policy-data/subs-to-notify/
{subsId}

PUT

Modify a subscription to receive notifications of policy data changes.

DELETE

Delete a subscription identified by {subsId}.

PlmnUePolicySet

/policy-data/plmns/{plmnId}/
ue-policy-set

GET

Retrieve the UE policy set data for an H-PLMN.

SlicePolicyControlData

/policy-data/slice-control-data/{snssai}

GET

Retrieve network slice specific policy control data for a given S-NSSAI.

PATCH

Modify network slice specific policy control data for a given S-NSSAI.

MBSSessionPolicyControlData

/policy-data/mbs-session-pol-data/{polSessionId}

GET

Retrieve MBS Session Policy Control Data for an MBS Session based on the MBS Session Identifier or an AF Application Identifier.

5.2.3 Resource: AccessAndMobilityPolicyData

5.2.3.1 Description

The resource represents all UE related mobility and access policies attributes in the UDR for a given "ueId".

5.2.3.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}/am-data

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

Table 5.2.3.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1

ueId

VarUeId

Represents the Subscription Identifier SUPI or GPSI. Data type VarUeId is defined in 3GPP TS 29.571 [7].

5.2.3.3 Resource Standard Methods

5.2.3.3.1 GET

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

Table 5.2.3.3.1-1: URI query parameters supported by the GET 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.3.3.1-2 and the response data structures and response codes specified in table 5.2.3.3.1-3.

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

AmPolicyData

M

1

200 OK

Upon success, a response body containing access and mobility policies shall be returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.4 Resource: UEPolicySet

5.2.4.1 Description

The resource represents UE policy set for a given "ueId" stored in the UDR of the H-PLMN.

5.2.4.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}/ue-policy-set

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

Table 5.2.4.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1

ueId

VarUeId

Represents the Subscription Identifier SUPI or GPSI. Data type VarUeId is defined in 3GPP TS 29.571 [7].

5.2.4.3 Resource Standard Methods

5.2.4.3.1 PUT

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

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

Table 5.2.4.3.1-2: Data structures supported by the PUT Request Body on this resource

Data type

P

Cardinality

Description

UePolicySet

M

1

Create or modify the UE policy set resource for a given subscriber.

Table 5.2.4.3.1-3: Data structures supported by the PUT Response Body on this resource

Data type

P

Cardinality

Response

codes

Description

UePolicySet

M

1

201 Created

Successful case.

The resource has been successfully created and a response body containing a representation of the created UEPolicySet resource shall be returned.

UePolicySet

M

1

200 OK

Successful case.

The resource has been successfully updated and a response body containing UE policies shall be returned.

n/a

204 No Content

Successful case.

The resource has been successfully updated and no additional content is to be sent in the response message.

NOTE: The mandatory HTTP error status codes for the PUT method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

Table 5.2.4.3.1-4: Headers supported by the 201 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

Contains the URI of the newly created resource, according to the structure: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}/ue-policy-set

5.2.4.3.2 PATCH

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

Table 5.2.4.3.2-1: URI query parameters supported by the PATCH 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.4.3.2-2 and the response data structures and response codes specified in table 5.2.4.3.2-3.

Table 5.2.4.3.2-2: Data structures supported by the PATCH Request Body on this resource

Data type

P

Cardinality

Description

UePolicySetPatch

M

1

Modify the UE policy set resource for a given subscriber.

Table 5.2.4.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

Successful case.

The resource has been successfully updated and no additional content is to be sent in the response message.

NOTE: The mandatory HTTP error status codes for the PATCH method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.4.3.3 GET

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

Table 5.2.4.3.3-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

supp-feat

SupportedFeatures

O

0..1

The features supported by the NF service consumer.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

UePolicySet

M

1

200 OK

Upon success, a response body containing the UE policies shall be returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.5 Resource: SessionManagementPolicyData

5.2.5.1 Description

The resource represents all PDU session related subscription attributes in the UDR for a given ueId.

5.2.5.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}/sm-data

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

Table 5.2.5.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

ueId

VarUeId

Represents the Subscription Identifier SUPI or GPSI. Data type VarUeId is defined in 3GPP TS 29.571 [7].

5.2.5.3 Resource Standard Methods

5.2.5.3.1 GET

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

Table 5.2.5.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

snssai

Snssai

O

0..1

Identifies a Single Network Slice Selection Assistance Information.

dnn

Dnn

O

0..1

Identifies a Data Network Name.

fields

array(string)

C

1..N

When the NF consumer only retrieves a subset of the resource, the "fields" query parameter shall be included. The "fields" query parameter contains the pointers of the attribute(s) to be retrieved.

supp-feat

SupportedFeatures

O

0..1

Identifies the features supported by the NF service consumer.

When an optional query parameter is not included, the UDR shall return session management policy data per DNN matching the value of the included query parameter(s) for all the possible values of the omitted query parameter. E.g. if "snssai" is not included, and "dnn" is included, UDR shall return the session management policy data per DNN for the DNN identified by "dnn" for all network slices where such DNN is available.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

SmPolicyData

M

1

200 OK

Upon success, a response body containing SmPolicyData shall be returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

NOTE: This release supports that only one PCF can access to the UDR to retrieve the SM Policy Data under one S-NSSAI and DNN association.

5.2.5.3.2 PATCH

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

Table 5.2.5.3.2-1: URI query parameters supported by the PATCH method on this resource

Name

Data type

P

Cardinality

Description

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

Table 5.2.5.3.2-2: Data structures supported by the PATCH Request Body on this resource

Data type

P

Cardinality

Description

SmPolicyDataPatch

M

1

When the "SessionManagementPolicyDataPatch" feature is supported, it requests the modification of the session management policy data for a subscriber.

Table 5.2.5.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

Successful case.

The resource has been successfully updated and no additional content is to be sent in the response message. (NOTE 2)(NOTE 3)

SmPolicyData

M

1

200 OK

Upon success, the execution report is returned. (NOTE 2)(NOTE 3)

NOTE 1: The mandatory HTTP error status codes for the PATCH method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

NOTE 2: If all the modification instructions in the PATCH request have been implemented, the UDR 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 supported the "PatchReport" feature, the UDR shall respond with SmPolicyData.

NOTE 3: When the resource is successfully updated, if the SmPolicyDataPatch in the request requires the creation, removal, or update of an entry of the "umData" attribute, the UDR shall create, remove or update the corresponding UsageMonitoringInformation resource for the indicated limit identifier.

5.2.6 Resource: UsageMonitoringInformation

5.2.6.1 Description

The resource represents an individual usage monitoring resource created in the UDR and associated with a ueId and a usageMonId.

5.2.6.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}/sm-data/{usageMonId}

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

Table 5.2.6.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

ueId

VarUeId

Represents the Subscription Identifier SUPI or GPSI. Data type VarUeId is defined in 3GPP TS 29.571 [7].

usageMonId

string

Unique identifier of the individual SM Policy usage monitoring resource. It contains the identity of the corresponding limit as defined in the "limitId" attribute of the UsageMonDataLimit data type (see clause 5.4.2.6).

5.2.6.3 Resource Standard Methods

5.2.6.3.1 PUT

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

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

Table 5.2.6.3.1-2: Data structures supported by the PUT Request Body on this resource

Data type

P

Cardinality

Description

UsageMonData

M

1

Create the usage monitoring resource.

Table 5.2.6.3.1-3: Data structures supported by the PUT Response Body on this resource

Data type

P

Cardinality

Response

codes

Description

UsageMonData

M

1

201 Created

Successful case.

The resource has been successfully created and a response body is returned containing a representation of the resource. (NOTE 2)

NOTE 1: The mandatory HTTP error status codes for the PUT method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

NOTE 2: When the resource is successfully created, the UDR shall create a new entry within the "umData" attribute of the SessionManagementPolicyData resource for the corresponding "limitId" accordingly.

Table 5.2.6.3.1-4: Headers supported by the 201 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

Contains the URI of the newly created resource, according to the structure: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}/sm-data/{usageMonId}

5.2.6.3.2 DELETE

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

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

Table 5.2.6.3.2-2: Data structures supported by the DELETE Request Body on this resource

Data type

P

Cardinality

Description

n/a

Table 5.2.6.3.2-3: Data structures supported by the DELETE Response Body on this resource

Data type

P

Cardinality

Response

codes

Description

n/a

204 No Content

Successful case.

The resource has been successfully deleted.

(NOTE 2)

NOTE 1: The mandatory HTTP error status codes for the DELETE method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

NOTE 2: When the resource is successfully deleted, the UDR shall delete within the "umData" attribute of the SessionManagementPolicyData resource the corresponding "limitId" entry accordingly.

5.2.6.3.3 GET

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

Table 5.2.6.3.3-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

supp-feat

SupportedFeatures

O

0..1

The features supported by the NF service consumer.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

UsageMonData

M

1

200 OK

Successful case.

The usage monitoring data is returned.

n/a

204 No Content

The resource was found but no usage monitoring data is available.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.7 Resource: SponsorConnectivityData

5.2.7.1 Description

The resource represents sponsored data connectivity related information stored in the UDR for a given sponsorId.

5.2.7.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/sponsor-connectivity-data/{sponsorId}

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

Table 5.2.7.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

sponsorId

string

Represents the sponsor identity.

5.2.7.3 Resource Standard Methods

5.2.7.3.1 GET

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

Table 5.2.7.3.1-1: URI query parameters supported by the GET 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.7.3.1-2 and the response data structures and response codes specified in table 5.2.7.3.1-3.

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

SponsorConnectivityData

M

1

200 OK

Upon success, a response body containing Sponsor Connectivity Data shall be returned.

n/a

204 No Content

The resource was found but no Sponsor Connectivity Data is available.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.8 Resource: BdtData

5.2.8.1 Description

The resource represents background data transfer data stored in the UDR.

5.2.8.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/bdt-data

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

Table 5.2.8.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

5.2.8.3 Resource Standard Methods

5.2.8.3.1 GET

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

Table 5.2.8.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

bdt-ref-ids

array(BdtReferenceId)

O

1..N

If included, this IE shall contain a list of the BDT reference identifiers.

Each member of the array is an individual BDT reference identifier.

supp-feat

SupportedFeatures

O

0..1

The features supported by the NF service consumer.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

array(BdtData)

M

0..N

200 OK

Upon success, a response body containing the BDT data shall be returned.

Each member of the array is an individual BDT data.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.9 Resource: IndividualBdtData

5.2.9.1 Description

The resource represents individual background data transfer data stored in the UDR for a given "bdtReferenceId".

5.2.9.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/bdt-data/{bdtReferenceId}

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

Table 5.2.9.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

bdtReferenceId

BdtReferenceId

Represents the transfer policy of background data transfer for provided ASP. Data type BdtReferenceId is defined in 3GPP TS 29.122 [9].

5.2.9.3 Resource Standard Methods

5.2.9.3.1 GET

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

Table 5.2.9.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

supp-feat

SupportedFeatures

O

0..1

The features supported by the NF service consumer.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

BdtData

M

1

200 OK

Upon success, a response body containing the BDT data shall be returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.9.3.2 PUT

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

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

Table 5.2.9.3.2-2: Data structures supported by the PUT Request Body on this resource

Data type

P

Cardinality

Description

BdtData

M

1

Create the BDT data for a given bdtReferenceId.

Table 5.2.9.3.2-3: Data structures supported by the PUT Response Body on this resource

Data type

P

Cardinality

Response

codes

Description

BdtData

M

1

201 Created

Successful case.

The resource has been successfully created.

ProblemDetails

O

0..1

403 Forbidden

The resource is not allowed to be updated.

(NOTE 2)

NOTE 1: The mandatory HTTP error status codes for the PUT method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

NOTE 2: The "cause" attribute within the "ProblemDetails" data structure may be set to "MODIFICATION_NOT_ALLOWED" as defined in table 5.2.7.2-1 of 3GPP TS 29.500 [4].

Table 5.2.9.3.2-4: Headers supported by the 201 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

Contains the URI of the newly created resource, according to the structure: {apiRoot}/nudr-dr/<apiVersion>/policy-data/bdt-data/{bdtReferenceId}

5.2.9.3.3 DELETE

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

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

Table 5.2.9.3.3-2: Data structures supported by the DELETE Request Body on this resource

Data type

P

Cardinality

Description

n/a

Table 5.2.9.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

Successful case.

The resource has been successfully deleted.

NOTE: The mandatory HTTP error status codes for the DELETE method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.9.3.4 PATCH

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

Table 5.2.9.3.4-1: URI query parameters supported by the PATCH 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.9.3.4-2 and the response data structures and response codes specified in table 5.2.9.3.4-3.

Table 5.2.9.3.4-2: Data structures supported by the PATCH Request Body on this resource

Data type

P

Cardinality

Description

BdtDataPatch

M

1

Modify the BDT data for a given bdtReferenceId.

Table 5.2.9.3.4-3: Data structures supported by the PATCH Response Body on this resource

Data type

P

Cardinality

Response codes

Description

BdtData

M

1

200 OK

The resource has been successfully updated and a response body containing BDT data shall be returned.

n/a

204 No Content

Successful case.

The resource has been successfully updated and no additional content is to be sent in the response message.

NOTE: The mandatory HTTP error status codes for the PATCH method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.10 Resource: PolicyDataSubscriptions

5.2.10.1 Description

This resource is used to represent subscriptions to notification of policy data modification.

5.2.10.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/subs-to-notify

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

Table 5.2.10.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

5.2.10.3 Resource Standard Methods

5.2.10.3.1 POST

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

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

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

Data type

P

Cardinality

Description

PolicyDataSubscription

M

1

Identifies the subscription to notification of policy data modification.

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

Data type

P

Cardinality

Response

codes

Description

PolicyDataSubscription

M

1

201 Created

Upon success, a response body containing a representation of each 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: The mandatory HTTP error status codes for the POST method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

Table 5.2.10.3.1-4: Headers supported by the 201 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

Contains the URI of the newly created resource, according to the structure: {apiRoot}/nudr-dr/<apiVersion>/policy-data/subs-to-notify/{subsId}

5.2.11 Resource: IndividualPolicyDataSubscription

5.2.11.1 Description

This resource is used to represent an individual subscription to notification of policy data modification.

5.2.11.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/subs-to-notify/{subsId}

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

Table 5.2.11.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

subsId

string

The subsId identifies an individual policy data subscription to notifications. The value is allocated by the UDR during creation of the PolicyDataSubscriptions resource.

5.2.11.3 Resource Standard Methods

5.2.11.3.1 PUT

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

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

Table 5.2.11.3.1-2: Data structures supported by the PUT Request Body on this resource

Data type

P

Cardinality

Description

PolicyDataSubscription

M

1

Updates the subscription to notification of policy data modification.

Table 5.2.11.3.1-3: Data structures supported by the PUT Response Body on this resource

Data type

P

Cardinality

Response

codes

Description

PolicyDataSubscription

M

1

200 OK

The individual subscription resource was updated successfully.

n/a

204 No Content

The individual subscription resource was updated successfully and no additional content is to be sent in the response message. This response code may not be provided if the "ImmediateReportPcc" feature is supported and the UDR needs to include an immediate report in the response.

NOTE: The mandatory HTTP error status codes for the PUT method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.11.3.2 DELETE

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

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

Table 5.2.11.3.2-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 5.2.11.3.2-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.

NOTE: The mandatory HTTP error status codes for the DELETE method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.12 Resource: OperatorSpecificData

5.2.12.1 Description

This resource represents the UE’s operator specific data.

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

5.2.12.2 Resource Definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}/operator-specific-data

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

Table 5.2.12.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

ueId

VarUeId

Represents the Subscription Identifier SUPI or GPSI. Data type VarUeId is defined in 3GPP TS 29.571 [7].

5.2.12.3 Resource Standard Methods

5.2.12.3.1 GET

This method is used to retrieve operator specific data from the UDR.

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

Table 5.2.12.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

fields

array(string)

C

1..N

When the NF consumer only retrieves a subset of the resource, the "fields" query parameter shall be included. The "fields" query parameter contains the pointers of the attribute(s) to be retrieved.

supp-feat

SupportedFeatures

O

0..1

Identifies the features supported by the NF service consumer.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

map(OperatorSpecificDataContainer)

M

0..N

200 OK

Upon success, a response body containing a map shall be returned. The key of the map is an operator specific data element name and the value is the operator specific data of such data element, for the current UE (identified by the {ueId} variable in the resource path).

If the resource does not contain any keys, the response consists of an empty JSON object (empty map).

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.12.3.2 PATCH

This method is used to modify operator specific data in the UDR.

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

Table 5.2.12.3.2-1: URI query parameters supported by the PATCH 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.12.3.2-2 and the response data structures and response codes specified in table 5.2.12.3.2-3.

Table 5.2.12.3.2-2: Data structures supported by the PATCH Request Body on this resource

Data type

P

Cardinality

Description

array(PatchItem)

M

1..N

Contains the delta data to the operator specific data

Table 5.2.12.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 successful modification there is no body in the response message.(NOTE 2)

PatchResult

M

1

200 OK

Upon success, the execution report is returned. (NOTE 2)

ProblemDetails

O

0..1

403 Forbidden

The resource is not allowed to be updated.

(NOTE 3)

NOTE 1: The mandatory HTTP error status codes for the PATCH method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

NOTE 2: If all the modification instructions in the PATCH request have been implemented, the UDR 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 supported the "PatchReport" feature, the UDR shall respond with PatchResult.

NOTE 3: The "cause" attribute within the "ProblemDetails" data structure may be set to "MODIFICATION_NOT_ALLOWED" as defined in table 5.2.7.2-1 of 3GPP TS 29.500 [4].

5.2.12.3.3 PUT

This method is used to create or modify operator specific data in the UDR.

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

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

Table 5.2.12.3.3-2: Data structures supported by the PUT Request Body on this resource

Data type

P

Cardinality

Description

map(OperatorSpecificDataContainer)

M

1..N

A map containing the new representation of the operator specific data. The key of the map is operator specific data element name and the value is the operator specific data of the UE.

Table 5.2.12.3.3-3: Data structures supported by the PUT Response Body on this resource

Data type

P

Cardinality

Response

codes

Description

map(OperatorSpecificDataContainer)

M

1

200 OK

Upon successful modification a response body containing a map shall be returned. The key of the map is operator specific data element name and the value is the operator specific data of the UE.

map(OperatorSpecificDataContainer)

M

1

201 Created

If the "OSDResource_Create_Delete" feature is supported and the resource has been successfully created, a response body is returned. The key of the map is operator specific data element name and the value is the operator specific data of the UE.

n/a

204 No Content

The resource has been successfully updated.

ProblemDetails

O

0..1

403 Forbidden

The resource is not allowed to be updated.

(NOTE 2)

NOTE 1: The mandatory HTTP error status codes for the PUT method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

NOTE 2: The "cause" attribute within the "ProblemDetails" data structure may be set to "MODIFICATION_NOT_ALLOWED" as defined in table 5.2.7.2-1 of 3GPP TS 29.500 [4].

Table 5.2.12.3.3-4: Headers supported by the 201 Response Code on this resource

Name

Data type

P

Cardinality

Description

Location

string

M

1

Contains the URI of the newly created resource, according to the structure: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ ues/{ueId}/operator-specific-data.

5.2.12.3.4 DELETE

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

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

Table 5.2.12.3.4-2: Data structures supported by the DELETE Request Body on this resource

Data type

P

Cardinality

Description

n/a

Table 5.2.12.3.4-3: Data structures supported by the DELETE Response Body on this resource

Data type

P

Cardinality

Response

codes

Description

n/a

204 No Content

Successful case, applicable when the "OSDResource_Create_Delete" feature is supported.

The resource has been successfully deleted.

NOTE: The mandatory HTTP error status codes for the DELETE method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.13 Resource: PlmnUePolicySet

5.2.13.1 Description

The resource represents the UE policy set for a given "plmnId" representing an H-PLMN stored in the UDR of a V‑PLMN.

5.2.13.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/plmns/{plmnId}/ue-policy-set

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

Table 5.2.13.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

plmnId

string

Concatenating a Mcc and Mnc as defined in 3GPP TS 29.505 [15].

5.2.13.3 Resource Standard Methods

5.2.13.3.1 GET

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

Table 5.2.13.3.1-1: URI query parameters supported by the GET 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.13.3.1-2 and the response data structures and response codes specified in table 5.2.13.3.1-3.

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

UePolicySet

M

1

200 OK

Upon success, a response body containing the UE policies shall be returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.14 Resource: PolicyDataForIndividualUe

5.2.14.1 Description

The resource represents all UE related policy data sets in the UDR for a given "ueId".

5.2.14.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/ues/{ueId}

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

Table 5.2.14.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1

ueId

VarUeId

Represents the Subscription Identifier SUPI or GPSI. Data type VarUeId is defined in 3GPP TS 29.571 [7].

5.2.14.3 Resource Standard Methods

5.2.14.3.1 GET

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

Table 5.2.14.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

supp-feat

SupportedFeatures

O

0..1

The features supported by the NF service consumer, as per clause 6.6 of 3GPP TS 29.500 [4].

data-subset-names

array(PolicyDataSubset)

O

2..N

The policy data subsets (e.g. AM policies, SM policies, etc.) requested by the NF service consumer.

If this query parameter is not provided by the NF service consumer, this means that all the available policy data subsets shall be returned.

NOTE: When two or more policy data subsets sets shall be retrieved, it is recommended to use a single GET request with query parameters.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

PolicyDataForIndividualUE

M

1

200 OK

Upon success, a response body containing the policy data subsets requested by the NF service consumer or all the policy data subsets shall be returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.15 Resource: SlicePolicyControlData

5.2.15.1 Description

The resource represents the network slice specific policy control subscription data stored in the UDR for a given S-NSSAI.

5.2.15.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/slice-control-data/{snssai}

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

Table 5.2.15.2-1: Resource URI variables for this resource

Name

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

snssai

Snssai

The S-NSSAI value used in the last segment of the resource URI is encoded as a string as defined in 3GPP TS 29.571 [7], clause 5.4.4.2.

5.2.15.3 Resource Standard Methods

5.2.15.3.1 GET

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

Table 5.2.15.3.1-1: URI query parameters supported by the GET method on this resource

Name

Data type

P

Cardinality

Description

supp-feat

SupportedFeatures

O

0..1

The features supported by the NF service consumer.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

SlicePolicyData

M

1

200 OK

Upon success, a response body containing network slice specific policy control data shall be returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.15.3.2 PATCH

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

Table 5.2.15.3.2-1: URI query parameters supported by the PATCH method on this resource

Name

Data type

P

Cardinality

Description

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

Table 5.2.15.3.2-2: Data structures supported by the PATCH Request Body on this resource

Data type

P

Cardinality

Description

SlicePolicyDataPatch

M

1

Modify a network slice specific policy control data resource for a given S-NSSAI.

Table 5.2.15.3.2-3: Data structures supported by the PATCH Response Body on this resource

Data type

P

Cardinality

Response codes

Description

SlicePolicyData

M

1

200 OK

The resource has been successfully updated and a response body containing network slice specific policy control data shall be returned.

n/a

204 No Content

The resource has been successfully updated and no additional content is to be sent in the response message.

NOTE: The mandatory HTTP error status codes for the PATCH method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.2.16 Resource: MBSSessionPolicyControlData

5.2.16.1 Description

The resource represents the MBS Session Policy Control Data for an MBS Session.

5.2.16.2 Resource definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/policy-data/mbs-session-pol-data/{polSessionId}

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

Data type

Definition

apiRoot

string

See 3GPP TS 29.504 [6] clause 6.1.1.

polSessionId

MbsSessPolDataId

Represents the identifier of the MBS Session Policy Control Data.

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

n/a

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

MbsSessPolCtrlData

M

1

200 OK

Successful case. The requested MBS Session Policy Control Data is successfully returned.

NOTE: The mandatory HTTP error status codes for the GET method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.3 Notifications

5.3.1 General

Notifications shall comply with clause 6.2 of 3GPP TS 29.500 [4] and clause 4.6.2.3 of 3GPP TS 29.501 [5].

This clause describes the resources to provide notification to NF service consumers which have subscribed to be notified when policy data is changed.

Table 5.3.1-1: Notifications overview

Notification

Callback URI

HTTP method or custom operation

Description

(service operation)

Policy Data Change Notification

{notificationUri}

POST

Used for policy data change notification

5.3.2 Policy Data Change Notification

The POST method shall be used for policy data change notification and the URI shall be provided during the subscription procedure.

Callback URI: {notificationUri}

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

Table 5.3.2-1: URI query parameters supported by the POST method

Name

Data type

P

Cardinality

Description

n/a

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

Table 5.3.2-2: Data structures supported by the POST Request Body

Data type

P

Cardinality

Description

array(PolicyDataChangeNotification)

M

1..N

Notification of policy data changes.

Table 5.3.2-3: Data structures supported by the POST Response Body

Data type

P

Cardinality

Response

codes

Description

n/a

204 No Content

The reception of the notification is acknowledged.

NOTE: The mandatory HTTP error status codes for the POST method listed in table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply.

5.4 Data Model

5.4.1 General

This clause specifies the application data model supported by the API.

Table 5.4.1-1 specifies the data types defined for the Nudr_DataRepository for Policy Data service based interface protocol.

Table 5.4.1-1: Nudr_DataRepository specific Data Types for Policy Data

Data type

Section defined

Description

Applicability

AmPolicyData

5.4.2.2

Contains the AM policy data for a given subscriber.

BdtData

5.4.2.9

Contains the background data transfer data.

BdtDataPatch

5.4.2.27

Contains the modifiable background data transfer data

BdtPolicyStatus

5.4.3.5

Contains the validation status for a negotiated BDT policy.

DnnRouteSelectionDescriptor

5.4.2.20

Contains the route selector parameters per DNN.

UpdatedItem

5.4.2.26

An updated resource fragment, represented by its location in a resource and its data type.

ConditionalSubscriptionwithPartialNotification

LimitIdToMonitoringKey

5.4.2.16

Contains the limit identifier and the corresponding monitoring key for a given S-NSSAI and DNN.

MbsSessPolCtrlData

5.4.2.31

Contains MBS Session Policy Control Data.

MbsSessPolDataId

5.4.2.32

Represents the identifier used to access the MBS Session Policy Control Data.

NotificationItem

5.4.2.25

Contains the list of resource fragments included in the notification triggered by the modification of a given resource fragment.

ConditionalSubscriptionwithPartialNotification

OsId

5.4.3.2

Operating System supported by the UE.

Periodicity

5.4.3.4

Indicates a type of time period.

PlmnRouteSelectionDescriptor

5.4.2.18

Contains the route selectors for a serving PLMN.

PolicyDataChangeNotification

5.4.2.11

Contains changed policy data for which notification was requested.

PolicyDataForIndividualUe

5.4.2.28

Contains policy data sets for a given subscriber.

PolicyDataSubscription

5.4.2.10

Identifies a subscription to policy data change notification.

PolicyDataSubset

5.4.3.6

Indicates a policy data subset (e.g. AM policy data, SM policy data).

SlicePolicyData

5.4.2.29

Contains network slice specific policy control information for an S-NSSAI.

SlicePolicyDataPatch

5.4.2.30

Contains modifiable network slice specific policy control information for an S-NSSAI.

SmPolicyData

5.4.2.5

Contains SM policy data for a subscriber.

SmPolicyDataPatch

5.4.2.21

Contains modifiable SM policy data for a subscriber.

SessionManagementPolicyDataPatch

SmPolicyDnnData

5.4.2.15

Contains SM policy data for a DNN and S-NSSAI.

SmPolicyDnnDataPatch

5.4.2.23

Contains modifiable SM policy data for a DNN and S-NSSAI.

SessionManagementPolicyDataPatch

SmPolicySnssaiData

5.4.2.14

Contains SM policy data for an S-NSSAI.

SmPolicySnssaiDataPatch

5.4.2.22

Contains modifiable SM policy data for an S-NSSAI.

SessionManagementPolicyDataPatch

SnssaiRouteSelectionDescriptor

5.4.2.19

Contains the route selector parameters per SNSSAI.

SponsorConnectivityData

5.4.2.8

Contains the sponsored data connectivity related information for a sponsor identifier.

ResourceItem

5.4.2.24

Represents list of fragments of a resource, i.e. a list of subsets of resource data monitored for notification of data changes.

ConditionalSubscriptionwithPartialNotification

ItemPath

5.4.3.2

Represents a fragment of a resource, i.e. a subset of resource data.

ConditionalSubscriptionwithPartialNotification

TimePeriod

5.4.2.12

Contains the periodicity for the defined usage monitoring data limits.

UePolicySetPatch

5.4.2.17

Contains the UE policy data that can be modified by the PCF.

UePolicySection

5.4.2.3

Contains the UE policy section.

UePolicySet

5.4.2.4

Contains the UE policy set for a given subscriber.

UsageMonLevel

5.4.3.3

Indicates the level of the usage monitoring instance (PDU Session level or per Service)

UsageMonData

5.4.2.7

Contains remain allowed usage data for a subscriber.

UsageMonDataLimit

5.4.2.6

Contains usage monitoring control data for a subscriber.

UsageMonDataScope

5.4.2.13

Contains SNSSAI and DNN combinations to which the UsageMonData instance belongs to.

Table 5.4.1-2 specifies data types re-used by the Nudr_DataRepository for Policy Data service based interface protocol from other specifications, including a reference to their respective specifications and when needed, a short description of their use within the Nudr_DataRepository for Policy Data service based interface.

Table 5.4.1-2: Nudr_DataRepository re-used Data Types for Policy Data

Data type

Reference

Comments

Applicability

5Qi

3GPP TS 29.571 [7]

Indicates the 5G QoS Identifier.

ArpPriorityLevel

3GPP TS 29.571 [7]

Indicates the allocation and retention priority level.

BdtReferenceId

3GPP TS 29.122 [9]

Indicates the background data transfer reference ID for the transfer policy.

BdtReferenceIdRm

3GPP TS 29.122 [9]

This data type is defined in the same way as the "BdtReferenceId" data type, but with the "nullable: true" property.

EnhancedBackgroundDataTransfer

BitRate

3GPP TS 29.571 [7]

String representing a bit rate that shall be formatted as follows:

pattern: "^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$"

Examples:

"125 Mbps", "0.125 Gbps", "125000 Kbps".

Bytes

3GPP TS 29.571 [7]

String with format "byte" as defined in OpenAPI Specification [3], i.e., base64-encoded characters.

ChargingInformation

3GPP TS 29.512 [12]

The address(es), and if available, the instance ID and the set ID of the Charging Function.

DateTime

3GPP TS 29.571 [7]

String with format "date-time" as defined in OpenAPI Specification [3].

Dnn

3GPP TS 29.571 [7]

Data Network Name. (NOTE)

MbsSessionId

3GPP TS 29.571 [7]

Contains the MBS Session Identifier.

NetworkAreaInfo

3GPP TS 29.554 [13]

Represents a network area information.

OperatorSpecificDataContainer

3GPP TS 29.505 [15]

Container for operator specific data

PatchResult

3GPP TS 29.571 [7]

PatchItem

3GPP TS 29.571 [7]

Data structure used for JSON patch.

PduSessionType

3GPP TS 29.571 [7]

PDU Session Type.

Pei

3GPP TS 29.571 [7]

Personal Equipment Identifier.

PlmnId

3GPP TS 29.571 [7]

PLMN Identity.

PresenceInfo

3GPP TS 29.571 [7]

Presence Reporting Area Information.

ProblemDetails

3GPP TS 29.571 [7]

Used in error responses to provide more detailed information about an error.

SliceMbr

3GPP TS 29.571 [7]

Contains the slice Maximum Bit Rate including UL and DL.

NSAC

Snssai

3GPP TS 29.571 [7]

Identifies the S-NSSAI.

SscMode

3GPP TS 29.571 [7]

SSC mode.

SupportedFeatures

3GPP TS 29.571 [7]

Used to negotiate the applicability of the optional features

TrafficDescriptor

3GPP TS 29.122 [9]

Identifies the traffic descriptor of the background data.

TransferPolicy

3GPP TS 29.554 [13]

Represents a transfer policy.

Uinteger

3GPP TS 29.571 [7]

Unsigned Integer, i.e. only value 0 and integers greater than 0 are allowed.

Uri

3GPP TS 29.571 [7]

String providing an URI.

UsageThreshold

3GPP TS 29.122 [9]

Usage Thresholds (a data volume expected to be transferred per UE and/or time duration in seconds).

VarUeId

3GPP TS 29.571 [7]

String represents the SUPI or GPSI.

NOTE: The UDR uses the DNN as received from the NF service consumer without applying any transformation. To successfully perform DNN matching, in a specific deployment a DNN shall always be encoded either with the full DNN (e.g., because there are multiple Operator Identifiers for a Network Identifier) or the DNN Network Identifier only.

5.4.2 Structured data types

5.4.2.1 Introduction

This clause defines the structures to be used in resource representations.

5.4.2.2 Type AmPolicyData

Table 5.4.2.2-1: Definition of type AmPolicyData

Attribute name

Data type

P

Cardinality

Description

praInfos

map(PresenceInfo)

O

1..N

Presence reporting area information. Each PresenceInfo element shall include the Presence Reporting Area Identifier within the "praId" attribute and, for a UE-dedicated presence reporting area, shall also include the list of elements composing the presence reporting area.

A "praId" may indicate a Presence Reporting Area Set.

The "praId" attribute within the PresenceInfo data type shall also be the key of the map.

The attribute "presenceState" shall not be present.

subscCats

array(string)

O

1..N

List of categories associated with the subscriber

5.4.2.3 Type UePolicySection

Table 5.4.2.3-1: Definition of type UePolicySection

Attribute name

Data type

P

Cardinality

Description

uePolicySectionInfo

Bytes

M

1

Contains the UE Policy Section Information for the given UPSI as specified in clause D.6.2 of 3GPP TS 24.501 [11].

upsi

string

M

1

Identifier for UE Policy Section. The format is represented in 3GPP TS 24.501 [11] clause D.6.2.

5.4.2.4 Type UePolicySet

Table 5.4.2.4-1: Definition of type UePolicySet

Attribute name

Data type

P

Cardinality

Description

praInfos

map(PresenceInfo)

O

1..N

Presence reporting area information. Each PresenceInfo element shall include the Presence Reporting Area Identifier within the "praId" attribute and, for a UE-dedicated presence reporting area, shall also include the list of elements composing the presence reporting area.

A "praId" may indicate a Presence Reporting Area Set.

The "praId" attribute within the PresenceInfo data type shall also be the key of the map.

The attribute "presenceState" shall not be present.

subscCats

array(string)

O

1..N

List of categories associated with the subscriber

uePolicySections

map(UePolicySection)

O

1..N

Contains the UE Policy Sections.

The UPSI (UE Policy Section Identifier) is used as the key in the map.

upsis

array(string)

O

1..N

List of identifiers for the "uePolicySections". The format of the UPSI is represented in 3GPP TS 24.501 [11] clause D.6.2

allowedRouteSelDescs

map(PlmnRouteSelectionDescriptor)

O

1..N

Contains allowed route selection descriptors per serving PLMN for a UE. The serving PLMN identifier is the key of the map.

andspInd

boolean

O

0..1

Indication of UE supporting ANDSP.

True: The UE supports ANDSP;

False: The UE does not support ANDSP.

pei

Pei

O

0..1

Personal Equipment Identifier.

osIds

array(OsId)

O

1..N

Identification of the UE Operating System(s).

suppFeat

SupportedFeatures

C

0..1

This IE represents a list of Supported features used as described in clause 5.6.

This attribute shall be provided in the PUT request and in the response of successful resource creation, and in the HTTP GET response if the "supp-feat" attribute query parameter is included in the HTTP GET request. (NOTE).

resetIds

array(string)

O

1..N

This IE uniquely identifies a part of temporary data in UDR that contains the created resource.

This attribute may be provided in the response of successful resource creation.

NOTE: In the HTTP request, it represents the set of features supported by the NF service consumer. In the HTTP response, it represents the set of features supported by both the NF service consumer and the UDR.

5.4.2.5 Type SmPolicyData

Table 5.4.2.5-1: Definition of type SmPolicyData

Attribute name

Data type

P

Cardinality

Description

Applicability

smPolicySnssaiData

map(SmPolicySnssaiData)

M

1..N

Session Management Policy data per S-NSSAI for all the SNSSAIs of the subscriber.

The key of the map is the S-NSSAI. (NOTE 2)

umDataLimits

map(UsageMonDataLimit)

O

1..N

Contains a list of usage monitoring profiles associated with the subscriber. The limit identifier is used as the key of the map.

umData

map(UsageMonData)

O

1..N

Contains the remaining allowed usage data associated with the subscriber.

The limit identifier is used as the key in the map.

suppFeat

SupportedFeatures

C

0..1

Indicates the list of negotiated supported features.

This parameter shall be supplied by the UDR in the response to the GET request when the GET request includes the "supp-feat" query parameter and the UDR supports feature negotiation for Session Management Policy Data.

resetIds

array(string)

O

1..N

This IE uniquely identifies a part of temporary data in UDR that contains the created resource.

This attribute may be provided in the response of successful resource creation.

NOTE 1: In this Release of the specification the "limitId" corresponds to the Monitoring Key.

NOTE 2: The S-NSSAI value used as key of the map is encoded as a string as defined in 3GPP TS 29.571[7], clause 5.4.4.2.

5.4.2.6 Type UsageMonDataLimit

Table 5.4.2.6-1: Definition of type UsageMonDataLimit

Attribute name

Data type

P

Cardinality

Description

limitId

string

M

1

Identifies the limit, i.e. the usage monitoring control instance

scopes

map(UsageMonDataScope)

O

1..N

Identifies the SNSSAI and DNN combinations to which the usage monitoring data limit applies.

The S-NSSAI is the key of the map. (NOTE 2)

If the "scopes" attribute is omitted, the limit applies to every S-NSSAI and DNN.

umLevel

UsageMonLevel

O

0..1

Indicates the level of the usage monitoring instance (PDU Session level or per Service).

startDate

DateTime

C

0..1

Start date and time when the usage monitoring instance applies. It shall be provided when the resetPeriod attribute is provided.

endDate

DateTime

O

0..1

End date and time when the usage monitoring instance applies.

usageLimit

UsageThreshold

O

0..1

Maximum allowed traffic volume/time usage for a usage monitoring instance. If a resetPeriod is specified, this limit applies to every period separately and not for the entire time between the start and end dates. So for example, if the resetPeriod is daily, the usageLimit is applicable for each day until the end date is specified.

resetPeriod

TimePeriod

O

0..1

Time period to reset the remaining allowed usage for a periodic usage monitoring instance (postpaid subscriptions). This attribute along with the startDate determine the actual absolute time at which usage needs to be reset.

NOTE 1: In this Release of the specification the "limitId" attribute is the Monitoring Key, and the "scopes" attribute shall always be present including one distinct SNSSAI and DNN pair.

NOTE 2: The S-NSSAI value used as key of the map is encoded as a string as defined in 3GPP TS 29.571[7], clause 5.4.4.2.

5.4.2.7 Type UsageMonData

Table 5.4.2.7-1: Definition of type UsageMonData

Attribute name

Data type

P

Cardinality

Description

Applicability

limitId

string

M

1

Identifies the limit as defined in the "limitId" attribute of the UsageMonDataLimit data type (see clause 5.4.2.6).

scopes

map(UsageMonDataScope)

O

1..N

Identifies the SNSSAI and DNN combinations to which the remaining usage monitoring data applies.

The S-NSSAI is the key of the map.

(NOTE 3)

umLevel

UsageMonLevel

O

0..1

Indicates the level of the usage monitoring instance (PDU Session level or per Service).

allowedUsage

UsageThreshold

O

0..1

Remaining allowed traffic volume usage and/or resource time usage.

resetTime

DateTime

O

0..1

Time to reset the allowed usage back to the usageLimit of the corresponding UsageMonDataLimit. This is computed based on the corresponding startDate, resetPeriod and endDate of the corresponding UsageMonDataLimit. The allowedUsage is only applicable if the resetTime is in the future relative to the current time.

suppFeat

SupportedFeatures

C

0..1

This IE represents a list of Supported features used as described in clause 5.6.

This attribute shall be provided in the PUT request and in the response of successful resource creation, and in the HTTP GET response if the "supp-feat" attribute query parameter is included in the HTTP GET request. (NOTE 2).

resetIds

array(string)

O

1..N

This IE uniquely identifies a part of temporary data in UDR that contains the created resource.

This attribute may be provided in the response of successful resource creation.

NOTE 1: In this Release of the specification the "limitId" attribute is the Monitoring Key, and the "scopes" attribute shall always be present including one distinct SNSSAI and DNN pair.

NOTE 2: In the HTTP request, it represents the set of features supported by the NF service consumer. In the HTTP response, it represents the set of features supported by both the NF service consumer and the UDR.

NOTE 3: The S-NSSAI value used as key of the map is encoded as a string as defined in 3GPP TS 29.571 [7], clause 5.4.4.2.

5.4.2.8 Type SponsorConnectivityData

Table 5.4.2.8-1: Definition of type SponsorConnectivityData

Attribute name

Data type

P

Cardinality

Description

aspIds

array(string)

M

1..N

Identifies a list of Application Service Provider Identifiers associated with the sponsor identity.

5.4.2.9 Type BdtData

Table 5.4.2.9-1: Definition of type BdtData

Attribute name

Data type

P

Cardinality

Description

aspId

string

M

1

This IE contains an identity of an application service provider.

transPolicy

TransferPolicy

M

1

This IE contains the transfer policy.

bdtRefId

BdtReferenceId

O

0..1

This IE indicates the background data transfer reference ID for the transfer policy.

nwAreaInfo

NetworkAreaInfo

O

0..1

This IE represents a network area information.

numOfUes

Uinteger

O

0..1

This IE contains the number of UEs using the indicated transfer policy. It shall be present when available.

volPerUe

UsageThreshold

O

0..1

This IE contains a data volume expected to be transferred per UE for the indicated transfer policy. It shall be present when available.

dnn

Dnn

O

0..1

This IE identifies a DNN.

snssai

Snssai

O

0..1

This IE identifies a slice.

trafficDes

TrafficDescriptor

O

0..1

Contains the traffic descriptor of the background data.

bdtpStatus

BdtPolicyStatus

O

0..1

Contains the validation status for a negotiated BDT policy. It shall be included when available. Default value is "VALID" if omitted.

suppFeat

SupportedFeatures

C

0..1

This IE represents a list of Supported features used as described in clause 5.6.

This attribute shall be provided in the PUT request and in the response of successful resource creation, and in the HTTP GET response if the "supp-feat" attribute query parameter is included in the HTTP GET request. (NOTE).

resetIds

array(string)

O

1..N

This IE uniquely identifies a part of temporary data in UDR that contains the created resource.

This attribute may be provided in the response of successful resource creation.

NOTE: In the HTTP request, it represents the set of features supported by the NF service consumer. In the HTTP response, it represents the set of features supported by both the NF service consumer and the UDR.

5.4.2.10 Type PolicyDataSubscription

Table 5.4.2.10-1: Definition of type PolicyDataSubscription

Attribute name

Data type

P

Cardinality

Description

Applicability

notificationUri

Uri

M

1

URI provided by the NF service consumer indicating where to receive the subscribed notifications from the UDR.

notifId

string

C

0..1

Notification Correlation ID assigned by the NF service consumer.
It shall be included when the "ConditionalSubscriptionwithPartialNotification" or the "ConditionalSubscriptionWithExcludeNotification" feature is supported.

ConditionalSubscriptionwithPartialNotification

ConditionalSubscriptionWithExcludeNotification

monitoredResourceUris

array(Uri)

M

1..N

A set of URIs that identify the resources as defined in table 5.2.2-1 for which a modification triggers a notification.

(NOTE 1)

monResItems

array(ResourceItem)

O

1..N

When present, this IE indicates the trigger of the notification is conditioned to the data change occurs in one or more of the attributes contained in a resource fragment as defined by the ResourceItem data type, and that the triggered notification shall only include the resource fragment as defined by the ResourceItem data type.

(NOTE 2)

ConditionalSubscriptionwithPartialNotification

excludedResItems

array(ResourceItem)

O

1..N

When present, this IE indicates the trigger of the notification is conditioned to the data change occurs in any attribute contained in the resource(s) identified by "monitoredResourceUris", except when the changed data is in one or more of the attributes contained in a resource fragment as defined by the ResourceItem data type.

(NOTE 2) (NOTE 3) (NOTE 4)

ConditionalSubscriptionWithExcludeNotification

immRep

boolean

O

0..1

If provided and set to "true", it indicates that existing entries that match this subscription shall be immediately reported within the "immReports" attribute in the response. The default value is false. The entries provided in the immediate report consider the "monitoredResourceUris" attribute and ignore any conditions potentially provided in the "monResItems" and "excludedResItems" attributes.

ImmediateReportPcc

immReports

array(PolicyDataChangeNotification)

O

1..N

Contains entries stored in the UDR that match this subscription.

It may be included only in the POST response body of a subscription creation or modification, and only if the request included the "immRep" attribute set to true.

ImmediateReportPcc

expiry

DateTime

C

0..1

This IE shall be included in a subscription response if, based on operator policy and taking into account the expiry time included in the request, the UDR needs to include an expiry time.

This IE may be included in a subscription request. When present, this IE shall represent the time after which the subscription becomes invalid.

The absence of this attribute in the subscription response means the subscription to be valid without an expiry time.

supportedFeatures

SupportedFeatures

C

0..1

Used to negotiate the applicability of the optional features.

This attribute shall be provided in the POST request and in the response of successful resource creation.

resetIds

array(string)

O

1..N

This IE uniquely identifies a part of temporary data in UDR that contains the created resource.

This attribute may be provided in the response of successful resource creation.

NOTE 1: Neither the resource URI of the IndividualPolicyDataSubscription resource nor the resource URI of the PolicyDataSubscriptions resource shall be included in the "monitoredResourceUris" attribute.

NOTE 2: If both ConditionalSubscriptionwithPartialNotification and ConditionalSubscriptionWithExcludeNotification are supported, the fragments defined in "monResItems" attribute and in "excludedResItems" attribute shall refer to different resources defined in "monitoredResourceUris".

NOTE 3: When "excludedResItems" attribute is included, and a change is detected in the monitored part of a resource (i.e., in those properties not included in the "excludedResItems" attribute), the triggered notification shall include the complete resource representation.

NOTE 4: The "excludedResItems" attribute may only be used with the OperatorSpecificData resource. E.g. if the OperatorSpecificData resource contains a map with two elements, one with key "operatorSpecificData1" and the other one with key "operatorSpecificData2", to excude the notification of changes in the "operatorSpecificData1" element the "excludedResItems" attribute will contain the value "/operatorSpecificData1" within the "items" array.

Editor’s Note: It is FFS if the immediate reporting will be applicable to conditional subscriptions as well.

5.4.2.11 Type PolicyDataChangeNotification

Table 5.4.2.11-1: Definition of type PolicyDataChangeNotification

Attribute name

Data type

P

Cardinality

Description

Applicability

amPolicyData

AmPolicyData

O

0..1

Access and Mobility Policy Data, if changed and notification was requested, or if it existed and immediate reporting was requested.

uePolicySet

UePolicySet

O

0..1

UE Policy Set, if changed and notification was requested, or if it existed and immediate reporting was requested.

plmnUePolicySet

UePolicySet

O

0..1

PLMN UE Policy Set, if changed and notification was requested, or if it existed and immediate reporting was requested.

smPolicyData

SmPolicyData

O

0..1

Session Management Policy Data, if changed and notification was requested, or if it existed and immediate reporting was requested.

usageMonData

UsageMonData

O

0..1

Usage Monitoring Data, if changed and notification was requested, or if it existed and immediate reporting was requested.

sponsorConnectivityData

SponsorConnectivityData

O

0..1

Sponsor data connectivity profile information, if changed and notification was requested, or if it existed and immediate reporting was requested.

bdtData

BdtData

O

0..1

Background Data Transfer Data, if changed and notification was requested, or if it existed and immediate reporting was requested.

opSpecData

OperatorSpecificDataContainer

O

0..1

Operator Specific Data, if changed and notification was requested, or if it existed and immediate reporting was requested. It may only be used when the receiver of the notification is able to univocally identify the changed operator specific data.

(NOTE 3)

opSpecDataMap

map(OperatorSpecificDataContainer)

O

1..N

Operator Specific Data resource data, if changed and notification was requested, or if it existed and immediate reporting was requested.

The key of the map is operator specific data element name and the value is the operator specific data of the UE.

OpSpecDataMapNotification

ueId

VarUeId

C

0..1

Represents the UE subscription identifier SUPI or GPSI. It shall only be present when the "amPolicyData", "uePolicySet", "smPolicyData", "opSpecData" and/or "usageMonData" attribute is present.

sponsorId

string

C

0..1

Represents the sponsor identity. It shall only be present when the "sponsorConnectivityData" attribute is present.

bdtRefId

BdtReferenceId

C

0..1

Represents the BDT reference identifier. It shall only be present when the "bdtData" attribute is present.

usageMonId

string

C

0..1

Represents the unique identifier of the individual SM Policy usage monitoring resource. It shall only be present when the "usageMonData" attribute is present.

plmnId

PlmnId

C

0..1

Represents the PLMN identifier. It shall only be present when the "plmnUePolicySet" attribute is present.

delResources

array(Uri)

O

1..N

The resources, as defined in table 5.2.2-1, if removed from UDR and notification on resource data change was requested. Not applicable for immediate reports. (NOTE 2)

ResourceRemovalNotificationPolicyData

notifId

string

C

0..1

Notification Correlation ID assigned by the NF service consumer.
It shall be included in notifications when the "ConditionalSubscriptionwithPartialNotification" feature is supported. Not applicable for immediate reports.

ConditionalSubscriptionwithPartialNotification

reportedFragments

array(NotificationItem)

O

1..N

This attribute contains the resource fragments indicated in the "monResItems" attribute of the PolicyDataSubscription data type. Not applicable for immediate reports.

ConditionalSubscriptionwithPartialNotification

slicePolicyData

SlicePolicyData

O

0..1

Network slice specific policy control data for an S-NSSAI, if changed and notification was requested, or if it existed and immediate reporting was requested.

snssai

Snssai

C

0..1

Represents the S-NSSAI identifier, the unique identifier of the SlicePolicyControlData resource. It shall only be present when the "slicePolicyData" attribute is present.

NOTE 1: When the "ResourceRemovalNotificationPolicyData" feature and/or "ConditionalSubscriptionwithPartialNotification" feature is not supported or supported but the applicable attribute(s) are not provided, at least one of the "amPolicyData", "uePolicySet", "smPolicyData", "usageMonData", "sponsorConnectivityData", "bdtData", "opSpecData", "plmnUePolicySet" or "slicePolicyData" shall be present.

NOTE 2: When the "ResourceRemovalNotificationPolicyData" feature is supported, and the "delResources" attribute is present, the attributes that correspond with the values included in the "delResources" attribute shall be omitted. E.g., when the "delResources" attribute includes the value "../policy-data/ues/{ueId}/am-data" the attribute "amPolicyData" shall be omitted.

NOTE 3: This attribute should not be used if the receiver of the notification is not able to univocally identify the changed operator specific data, and "opSpecDataMap" should be used instead.

Editor’s Note: It is FFS if the immediate reporting will be applicable to conditional subscriptions as well.

5.4.2.12 Type TimePeriod

Table 5.4.2.12-1: Definition of type TimePeriod

Attribute name

Data type

P

Cardinality

Description

Applicability

period

Periodicity

M

1

Indicates whether the periodicity is "YEARLY", "MONTHLY", "WEEKLY", "DAILY" or "HOURLY".

maxNumPeriod

Uinteger

O

0..1

Indicates the maximum number of periods after which the usage monitoring instance does not apply. If omitted, there is no limit in the number of periods.

5.4.2.13 Type UsageMonDataScope

Table 5.4.2.13-1: Definition of type UsageMonDataScope

Attribute name

Data type

P

Cardinality

Description

Applicability

snssai

Snssai

M

1

Represents the SNSSAI.

dnn

array(Dnn)

O

1..N

Represents the Dnn. If omitted, the usage monitoring scope applies to all the DNNs.

NOTE: In this Release of the specification the "dnn" attribute shall always be present with one and only one entry.

5.4.2.14 Type SmPolicySnssaiData

Table 5.4.2.14-1: Definition of type SmPolicySnssaiData

Attribute name

Data type

P

Cardinality

Description

Applicability

snssai

Snssai

M

1

S-NSSAI associated with the data.

smPolicyDnnData

map(SmPolicyDnnData)

O

1..N

Session Management Policy data per DNN for all the DNNs of the indicated S-NSSAI. The key of the map is the DNN.

ueSliceMbr

SliceMbr

O

0..1

Subscribed UE-Slice-MBR for the indicated S-NSSAI.

NSAC

5.4.2.15 Type SmPolicyDnnData

Table 5.4.2.15-1: Definition of type SmPolicyDnnData

Attribute name

Data type

P

Cardinality

Description

Applicability

dnn

Dnn

M

1

DNN associated with the data

allowedServices

array(string)

O

1..N

List of subscriber’s allowed service identifiers

subscCats

array(string)

O

1..N

List of categories associated with the subscriber

gbrUI

BitRate

O

0..1

Maximum aggregate UL bitrate that can be provided across all GBR QoS Flows in the DNN

gbrDl

BitRate

O

0..1

Maximum aggregate DL bitrate that can be provided across all GBR QoS Flows in the DNN

adcSupport

boolean

O

0..1

Indicates whether application detection and control is enabled for the PDU session.

True: Application detection and control is enabled for the PDU session;
False: Application detection and control is not enabled for the PDU session.

The absence of this attribute means that ADC support is not provisioned for the UE and PDU session.

subscSpendingLimits

boolean

O

0..1

Indicates whether the PCF must enforce policies based on subscriber spending limits.

True: Spending limit control is enabled;
False: Spending limit control is not enabled.

The absence of this attribute means that spending limit control is not provisioned for the UE and PDU session.

ipv4Index

IpIndex

O

0..1

Information that identifies which IP pool or external server is used to allocate the IPv4 address.

ipv6Index

IpIndex

O

0..1

Information that identifies which IP pool or external server is used to allocate the IPv6 address.

offline

boolean

O

0..1

Indicates whether the offline charging is applicable to the PDU session.

True: Offline charging is applicable to the PDU session;
False: Offline charging is not applicable to the PDU session.

The absence of this attribute means that the charging method is not provisioned for the UE and PDU session.

online

boolean

O

0..1

Indicates whether the online charging is applicable to the PDU session.

True: Online charging is applicable to the PDU session;

False: Online charging is not applicable to the PDU session.

The absence of this attribute means that the charging method is not provisioned for the UE and PDU session.

chfInfo

ChargingInformation

O

0..1

The address(es) and, if available, the CHF instance ID and the CHF set ID of the Charging Function. (NOTE)

refUmdLimitIds

map(LimitIdToMonitoringKey)

O

1..N

A reference to the "UsageMonitoringDataLimit" or "UsageMonitoringData" instances for this DNN and SNSSAI that may also include the related monitoring key(s). The key of the map is the limit identifier.

mpsPriority

boolean

O

0..1

True: Indicates subscription to the MPS priority service; priority applies to all traffic on the PDU Session.

False: MPS priority service is not subscribed.

The absence of this attribute means that MPS priority is not provisioned for the UE and PDU session.

mcsPriority

boolean

O

0..1

True: Indicates subscription to the MCS priority service; priority applies to all traffic on the PDU Session.

False: IMS signalling priority service is not subscribed.

The absence of this attribute means that IMS signalling priority is not provisioned for the UE and PDU session.

imsSignallingPrio

boolean

O

0..1

True: Indicates subscription to the IMS signalling priority service; priority only applies to IMS signalling traffic.

False: IMS signalling priority service is not subscribed.

The absence of this attribute means that IMS signalling priority is not provisioned for the UE and PDU session.

mpsPriorityLevel

integer

O

0..1

Relative priority level for the multimedia priority services

mcsPriorityLevel

integer

O

0..1

Relative priority level for the mission critical services

praInfos

map(PresenceInfo)

O

1..N

Presence reporting area information. Each PresenceInfo element shall include the Presence Reporting Area Identifier within the "praId" attribute and, for a UE-dedicated presence reporting area, shall also include the list of elements composing the presence reporting area.

A "praId" may indicate a Presence Reporting Area Set.

The "praId" attribute within the PresenceInfo data type shall also be the key of the map.

The attribute "presenceState" shall not be present.

bdtRefIds

map(BdtReferenceIdRm)

O

1..N

Identifies transfer policies of background data transfer.

Any string value can be used as a key of the map.

EnhancedBackgroundDataTransfer

locRoutNotAllowed

boolean

O

0..1

Identifies whether AF influence on traffic routing is allowed or not.

True: if no local routing is allowed;

False: local routing is allowed.

The absence of this attribute means that AF influence on traffic routing is not provisioned for the UE and PDU session.

NOTE: When the feature "CHFsetSupport" is supported, the "secondaryChfAddress" may be omitted (see 3GPP TS 29.512 [12], clause 4.2.2.3.1).

5.4.2.16 Type LimitIdToMonitoringKey

Table 5.4.2.16-1: Definition of type LimitIdToMonitoringKey

Attribute name

Data type

P

Cardinality

Description

Applicability

limitId

string

M

1

Limit Identifier.

monKeys

array(string)

O

1..N

Monitoring Keys.

NOTE: In this Release of the specification there is only one Monitoring Key per Limit Identifier

5.4.2.17 Type UePolicySetPatch

Table 5.4.2.17-1: Definiton of type UePolicySetPatch

Attribute name

Data type

P

Cardinality

Description

uePolicySections

map(UePolicySection)

O

1..N

Contains the UE Policy Sections.

The UPSI (UE Policy Section Identifier) is used as the key in the map.

upsis

array(string)

O

1..N

List of identifiers for the "uePolicySections". The format of the UPSI is represented in 3GPP TS 24.501 [11] clause D.6.2.

andspInd

boolean

O

0..1

Indication of UE supporting ANDSP.

pei

Pei

O

0..1

Personal Equipment Identifier.

osIds

array(OsId)

O

1..N

Identification of the UE Operating System(s).

5.4.2.18 Type PlmnRouteSelectionDescriptor

Table 5.4.2.18-1: Definition of type PlmnRouteSelectionDescriptor

Attribute name

Data type

P

Cardinality

Description

servingPlmn

PlmnId

M

1

Identity of the serving PLMN.

snssaiRouteSelDescs

array(SnssaiRouteSelectionDescriptor)

O

1..N

Contains the route selection descriptor parameters (DNNs, PDU session types, SSC modes and the ATSSS information) per SNSSAI.

5.4.2.19 Type SnssaiRouteSelectionDescriptor

Table 5.4.2.19-1: Definition of type SnssaiRouteSelectionDescriptor

Attribute name

Data type

P

Cardinality

Description

snssai

Snssai

M

1

SNSSAI.

dnnRouteSelDescs

array(DnnRouteSelectionDescriptor)

O

1..N

Contains the route selection descriptor parameters (PDU session types, SSC modes and the ATSSS information) per DNN.

5.4.2.20 Type DnnRouteSelectionDescriptor

Table 5.4.2.20-1: Definition of type DnnRouteSelectionDescriptor

Attribute name

Data type

P

Cardinality

Description

dnn

Dnn

M

1

DNN.

sscModes

array(SscMode)

O

1..N

Contains the allowed SSC modes for the traffic to this DNN.

pduSessTypes

array(PduSessionType)

O

1..N

Contains the allowed PDU Session types for the traffic to this DNN.

atsssInfo

boolean

O

0..1

Indicates whether MA PDU session establishment is allowed for this DNN.

True: MA PDU session establishment is allowed for this DNN.

False: MA PDU session establishment is not allowed for this DNN.

The absence of this attribute means that the ATSSS information is not provisioned for the UE and PDU session.

5.4.2.21 Type SmPolicyDataPatch

Table 5.4.2.21-1: Definition of type SmPolicyDataPatch

Attribute name

Data type

P

Cardinality

Description

Applicability

umData

map(UsageMonData)

O

1..N

Contains the remaining allowed usage data associated with the subscriber.

The value of the limit identifier is used as the key in the map.

smPolicySnssaiData

map(SmPolicySnssaiDataPatch)

O

1..N

Modifiable Session Management Policy data per S-NSSAI for all the SNSSAIs of the subscriber.

The key of the map is the S-NSSAI. (NOTE 2)

NOTE 1: In this Release of the specification the "limitId" corresponds to the Monitoring Key.

NOTE 2: The S-NSSAI value used as key of the map is encoded as a string as defined in 3GPP TS 29.571[7], clause 5.4.4.2.

5.4.2.22 Type SmPolicySnssaiDataPatch

Table 5.4.2.22-1: Definition of type SmPolicySnssaiDataPatch

Attribute name

Data type

P

Cardinality

Description

Applicability

snssai

Snssai

M

1

S-NSSAI associated with the data.

smPolicyDnnData

map(SmPolicyDnnDataPatch)

O

1..N

Modifiable Session Management Policy data per DNN for all the DNNs of the indicated S-NSSAI. The key of the map is the DNN.

5.4.2.23 Type SmPolicyDnnDataPatch

Table 5.4.2.23-1: Definition of type SmPolicyDnnDataPatch

Attribute name

Data type

P

Cardinality

Description

Applicability

dnn

Dnn

M

1

DNN associated with the data

bdtRefIds

map(BdtReferenceIdRm)

O

1..N

Updated transfer policies of background data transfer.

Any string value can be used as a key of the map.

EnhancedBackgroundDataTransfer

5.4.2.24 Type ResourceItem

Table 5.4.2.24-1: Definition of type ResourceItem

Attribute name

Data type

P

Cardinality

Description

Applicability

monResourceUri

Uri

M

1

Represents the URI that identifies the monitored resource as defined in table 5.2.2-1.

(NOTE)

items

array(ItemPath)

M

1..N

Represents fragments of the resource identified by the "monResource" attribute, i.e. a subset of resource data, for which a modification triggers a notification.

NOTE: The resource URI included in the "monResourceUri" attribute shall be one of the resource URIs included in the "monitoredResourceUris" attribute of the PolicyDataSubscription data type.

5.4.2.25 Type NotificationItem

Table 5.4.2.25-1: Definition of type NotificationItem

Attribute name

Data type

P

Cardinality

Description

Applicability

resourceId

Uri

M

1

This IE contains the URI of the resource which has been changed.

notifItems

array(UpdatedItem)

M

1..N

This IE contains the fragments of the resource identified by the "resourceId" attribute which have been updated or requested to be notified.

5.4.2.26 Type UpdatedItem

Table 5.4.2.26-1: Definition of type UpdatedItem

Attribute name

Data type

P

Cardinality

Description

Applicability

item

ItemPath

M

1

This IE contains a JSON pointer value (as defined in IETF RFC 6901 [20]) that references a target location within the resource that identifies the resource fragment.

value

Any type

M

1

This IE indicates the value of the resource fragment located at the target location within the resource specified in the "fragmentPath" attribute.

The data type of this attribute shall be the same as the type of the attribute or element located in the path.

The null value shall be allowed.

5.4.2.27 Type BdtDataPatch

Table 5.4.2.27-1: Definition of type BdtDataPatch

Attribute name

Data type

P

Cardinality

Description

bdtpStatus

BdtPolicyStatus

O

0..1

Contains the validation status for a negotiated BDT policy. It shall be included when the BDT policy is re-negotiated.

transPolicy

TransferPolicy

O

0..1

This IE contains the transfer policy.

5.4.2.28 Type PolicyDataForIndividualUe

Table 5.4.2.28-1: Definition of type PolicyDataForIndividualUe

Attribute name

Data type

P

Cardinality

Description

Applicability

uePolicyDataSet

UePolicySet

O

0..1

The IE contains UE policies.

smPolicyDataSet

SmPolicyData

O

0..1

The IE contains SM policies.

amPolicyDataSet

AmPolicyData

O

0..1

The IE contains AM policies.

umData

map(UsageMonData)

C

1..N

The IE contains UM policies.

The value of the limit identifier is used as the key of the map.

(NOTE)

operatorSpecificDataSet

map(OperatorSpecificDataContainer)

O

1..N

The IE contains operator specific data.

The key of the map is operator specific data element name and the value is the operator specific data of the UE.

NOTE: The "umData" attribute shall be absent when the smPolicyDataSet attribute is present and includes the "umData" attribute.

5.4.2.29 Type SlicePolicyData

Table 5.4.2.29-1: Definition of type SlicePolicyData

Attribute name

Data type

P

Cardinality

Description

Applicability

mbrUl

BitRate

O

0..1

Maximum aggregate ULdata rate that can be provided across all GBR and Non-GBR QoS Flows in the S-NSSAI.

(NOTE 1)

mbrDl

BitRate

O

0..1

Maximum aggregate DL data rate that can be provided across all GBR and Non-GBR QoS Flows in the S-NSSAI.

(NOTE 1)

remainMbrUl

BitRate

O

0..1

The remaining maximum aggregate UL data rate that can be provided across all GBR and Non-GBR QoS Flows in the S-NSSAI. (NOTE 2)

It is set to the maximum allowed aggregate UL data rate across all GBR and Non-GBR QoS Flows in the S-NSSAI when the system is initially configured based on operator policies.

remainMbrDl

BitRate

O

0..1

The remaining maximum aggregate DL data rate that can be provided across all GBR and Non-GBR QoS Flows in the S-NSSAI. (NOTE 2)

It is set to the maximum allowed aggregate DL data rate across all GBR and Non-GBR QoS Flows in the S-NSSAI when the system is initially configured based on operator policies.

suppFeat

SupportedFeatures

C

0..1

Indicates the list of negotiated supported features.

It shall be provided in the HTTP GET response if the "supp-feat" attribute query parameter is included in the HTTP GET request.

resetIds

array(string)

O

1..N

This IE uniquely identifies a part of temporary data in UDR that contains the created resource.

This attribute may be provided in the response of successful resource creation.

NOTE 1: The "mbrUl" and "mbrDl" attributes are only used for limiting data rate per network slice with assistance of the NWDAF.

NOTE 2: The "remainMbrUl" and "remainMbrDl" attributes are only used for limiting data rate per network slice with PCF based monitoring.

5.4.2.30 Type SlicePolicyDataPatch

Table 5.4.2.30-1: Definition of type SlicePolicyDataPatch

Attribute name

Data type

P

Cardinality

Description

Applicability

remainMbrUl

BitRate

O

0..1

The remaining maximum aggregate UL bitrate that can be provided across all GBR and Non-GBR QoS Flows in the S-NSSAI.

remainMbrDl

BitRate

O

0..1

The remaining maximum aggregate DL bitrate that can be provided across all GBR and Non-GBR QoS Flows in the S-NSSAI.

NOTE: At least one of the attributes shall be included.

5.4.2.31 Type MbsSessPolCtrlData

Table 5.4.2.31-1: Definition of type MbsSessPolCtrlData

Attribute name

Data type

P

Cardinality

Description

Applicability

5qis

array(5Qi)

O

1..N

Contains the list of allowed 5QI(s) for an MBS PCC rule of the MBS Session.

maxMbsArpLevel

ArpPriorityLevel

O

0..1

Contains the highest ARP level value allowed for any MBS PCC rule of the MBS Session.

maxMbsSessionAmbr

BitRate

O

0..1

Contains the maximum MBS Session-AMBR for all non-GBR QoS flows of an MBS session in the downlink.

maxGbr

BitRate

O

0..1

Contains the maximum aggregated bitrate that can be provided across all the GBR QoS Flows for an MBS session in the downlink.

suppFeat

SupportedFeatures

C

0..1

Indicates the list of negotiated supported features.

This parameter shall be provided if feature negotiation needs to take place.

5.4.2.32 Type MbsSessPolDataId

Table 5.4.2.32-1: Definition of type MbsSessPolDataId

Attribute name

Data type

P

Cardinality

Description

Applicability

mbsSessionId

MbsSessionId

C

0..1

Contains the source specific multicast address used as MBS session identifier.

(NOTE)

afAppId

string

C

0..1

Contains the AF application identifier.

(NOTE)

NOTE: Either the "mbsSessionId" attribute or the "afAppId" attribute shall be provided.

5.4.3 Simple data types and enumerations

5.4.3.1 Introduction

This clause defines simple data types and enumerations that can be referenced from data structures defined in the previous clauses.

5.4.3.2 Simple data types

The simple data types defined in table 5.4.3.2-1 shall be supported.

Table 5.4.3.2-1: Simple data types

Type Name

Type Definition

Description

Applicability

IpIndex

integer

Information that identifies which IP pool or external server is used to allocate the IP address.

ItemPath

string

It contains one JSON pointer value (as defined in IETF RFC 6901 [20]) that references a target location within the resource represented in the "monResource" attribute and "notifiedItems" attribute.

E.g. "/smPolicySnssaiData/<snssai>" represents the subscription to data changes in the SmPolicyData data document, in particular to the element of the "smPolicySnssaiData" map whose key is identified by the <snssai> value.

E.g. 2 "/smPolicySnssaiData/<snssai>/smPolicyDnnData/<dnn>" represents the subscription to data changes in the SmPolicyData data document, in particular to the element of the "smPolicySnssaiData" map whose key is identified by the <snssai> value and, within this one, to the element of the "smPolicyDnnData" map whose key is identified by the <dnn> value.

(NOTE)

ConditionalSubscriptionwithPartialNotification

OsId

string

Operating System of the served UE. It contains a Universally Unique IDentifier (UUID) as specified in IETF RFC 4122 [17]. The format of the OS Id is represented in 3GPP TS 24.501 [11].

NOTE: The S-NSSAI value used as key of the map is encoded as a string as defined in 3GPP TS 29.571[7], clause 5.4.4.2.

5.4.3.3 Enumeration: UsageMonLevel

The enumeration represents the usage monitoring level. It shall comply with the provisions defined in table 5.4.3.3-1.

Table 5.4.3.3-1: Enumeration UsageMonLevel

Enumeration value

Description

SESSION_LEVEL

The usage monitoring is applicable for PDU session level.

SERVICE_LEVEL

The usage monitoring is applicable for service level.

5.4.3.4 Enumeration: Periodicity

The enumeration represents the time period. It shall comply with the provisions defined in table 5.4.3.4-1.

Table 5.4.3.4-1: Enumeration Periodicity

Enumeration value

Description

YEARLY

Time period is yearly

MONTHLY

Time period is monthly

WEEKLY

Time period is weekly

DAILY

Time period is daily

HOURLY

Time period is hourly

5.4.3.5 Enumeration: BdtPolicyStatus

The enumeration represents the validation status of the BDT policy. It shall comply with the provisions defined in table 5.4.3.5-1.

Table 5.4.3.5-1: Enumeration BdtPolicyStatus

Enumeration value

Description

INVALID

This value is used to indicate that the BDT policy is invalid while the BDT policy re-negotiation is ongoing because the network performance has degraded.

VALID

This value is used to indicate that the BDT policy is valid.

5.4.3.6 Enumeration: PolicyDataSubset

This enumeration indicates the policy data subsets (e.g. AM policy data, SM policy data, etc.). It shall comply with the provisions of table 5.4.3.6-1.

Table 5.4.3.6-1: Enumeration PolicyDataSubset

Enumeration value

Description

AM_POLICY_DATA

AM policy data.

SM_POLICY_DATA

SM policy data.

UE_POLICY_DATA

UE policy data.

UM_DATA

Usage Monitoring data.

OPERATOR_SPECIFIC_DATA

Operator specific data.

5.5 Error handling

5.5.1 General

For the Nudr_DataRepository service API for Policy Data, HTTP error responses shall be supported as specified in clause 4.8 of 3GPP TS 29.501 [5]. Protocol errors and application errors specified in table 5.2.7.2-1 of 3GPP TS 29.500 [4] shall be supported for an HTTP method if the corresponding HTTP status codes are specified as mandatory for that HTTP method in table 5.2.7.1-1 of 3GPP TS 29.500 [4].

In addition, the requirements in the following clauses are applicable for the Nudr_DataRepository service API for Policy Data.

5.5.2 Protocol Errors

No specific procedures for the Nudr_DataRepository service API for Policy Data are specified.

5.5.3 Application Errors

The application errors defined for the Nudr_DataRepository service API for Policy Data are listed in table 5.5.3-1.

Table 5.5.3-1: Application errors

Application Error

HTTP status code

Description

NOTE: Including a "ProblemDetails" data structure with the "cause" attribute in the HTTP response is optional unless explicitly mandated by other clauses in this document.

The application error handling shall follow 3GPP TS 29.504 [6] clause 6.1.6 unless explicitly specified in this document.

5.6 Feature negotiation

The optional features in table 6.1.8-1 of 3GPP TS 29.504 [6] are defined for the Nudr_DataRepository API. They shall be negotiated using the extensibility mechanism defined in clause 6.6 of 3GPP TS 29.500 [4].