5.2.48 Resource: ServiceSpecificAuthorizationData

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

5.2.48.1 Description

This resource represents a GPSI’s subscribed AuthorizationData for a specific service. It is queried by the UDM during Authorization Data Retrieval for a specific service and Service Specific Authorization Data Update Notification.

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

5.2.48.2 Resource Definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/subscription-data/{ueId}/service-specific-authorization-data/{serviceType}

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

Table 5.2.48.2-1: Resource URI variables for this resource

Name

Definition

apiRoot

See 3GPP TS 29.504 [2] clause 6.1.1

ueId

Represents the Generic Public Subscription Identifier (see 3GPP TS 23.501 [4] clause 5.9.8)
pattern: ‘^(msisdn-[0-9]{5,15}|.+|extid-[^@]+@[^@]+|extgroupid-[^@]+@[^@]+)$’

serviceType

In this release the only defined Service Type is "AF_GUIDANCE_FOR_URSP"

5.2.48.3 Resource Standard Methods

5.2.48.3.1 GET

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

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

Name

Data type

P

Cardinality

Description

single-nssai

Snssai

O

0..1

When present without Slice Differentiator (sd), all slices identified by the given Slice/Service Type (sst) and any sd value (if any) shall be considered matching the query parameter.

dnn

Dnn

O

0..1

mtc-provider-information

MtcProviderInformation

O

0..1

af-id

string

O

0..1

When present, indicates the string identifying the originating AF.

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

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

Data type

P

Cardinality

Description

n/a

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

Data type

P

Cardinality

Response

codes

Description

AuthorizationData

M

1

200 OK

Upon success, a response body containing the Authorization Data shall be returned.

ProblemDetails

O

1

404 Not Found

The "cause" attribute may be used to indicate one of the following application errors:

– USER_NOT_FOUND

– DATA_NOT_FOUND

ProblemDetails

O

0..1

403 Forbidden

The "cause" attribute may be used to indicate one of the following application errors:

– DNN_NOT_ALLOWED

– MTC_PROVIDER_NOT_ALLOWED

– AF_INSTANCE_NOT_ALLOWED

– SNSSAI_NOT_ALLOWED

NOTE: In addition, common data structures as listed in table 5.5-1 are supported.