5.2.3 Resource: AccessAndMobilitySubscriptionData

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

5.2.3.1 Description

This resource represents the subscribed AccessAndMobilitySubscriptionData for a SUPI for use in a serving PLMN. It is queried by the AMF via the UDM after registering.

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

5.2.3.2 Resource Definition

Resource URI: {apiRoot}/nudr-dr/<apiVersion>/subscription-data/{ueId}/{servingPlmnId}/provisioned-data/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

Definition

apiRoot

See 3GPP TS 29.504 [2] clause 6.1.1

ueId

Represents the Subscription Identifier SUPI or GPSI (see 3GPP TS 23.501 [4] clause 5.9.2)
pattern: See pattern of type VarUeId 3GPP TS 29.571 [3]

servingPlmnId

Represents the Serving PLMN ID (consisting of MCC, MNC) or SNPN (consisting of MCC, MNC and NID); see clauses 12.1 and 17.2 in 3GPP TS 23.003 [5].
pattern: "^[0-9]{5,6}(-[A-Fa-f0-9]{11})?$"

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

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.

supported-features

SupportedFeatures

O

0..1

see 3GPP TS 29.500 [8] clause 6.6

This method shall support the request data structures specified in table 5.2.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

AccessAndMobilitySubscriptionData

M

1

200 OK

Upon success, a response body containing the Access and Mobility Subscription Data shall be returned.

For the roaming and SNPN scenarios, see the description of the ‘roamingRestrictions’ attribute in the Table 6.1.6.2.4-1 of 3GPP TS 29.503 [6].

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