5.3 Data Types related to Subscription, Identification and Numbering
29.5713GPP5G SystemCommon Data Types for Service Based InterfacesRelease 18Stage 3TS
5.3.1 Introduction
This clause defines common data types related to subscription, identification and numbering information.
5.3.2 Simple Data Types
This clause specifies common simple data types.
Table 5.3.2-1: Simple Data Types
Type Name |
Type Definition |
Description |
Dnn |
string |
String representing a Data Network as defined in clause 9A of 3GPP TS 23.003 [7]; it shall contain either a DNN Network Identifier, or a full DNN with both the Network Identifier and Operator Identifier, as specified in 3GPP TS 23.003 [7] clause 9.1.1 and 9.1.2. It shall be coded as string in which the labels are separated by dots (e.g. "Label1.Label2.Label3"). See NOTE 2. |
DnnRm |
string |
This data type is defined in the same way as the "Dnn" data type, but with the OpenAPI "nullable: true" property. |
WildcardDnn |
string |
String representing the Wildcard DNN. It shall contain the string "*". Pattern: ‘^[*]$’ |
WildcardDnnRm |
string |
This data type is defined in the same way as the "WildcardDnn" data type, but with the OpenAPI "nullable: true" property. |
Gpsi |
string |
String identifying a Gpsi shall contain either an External Id or an MSISDN. It shall be formatted as follows: -External Identifier: "extid-<extid>, where <extid> shall be formatted according to clause 19.7.2 of 3GPP TS 23.003 [7] that describes an External Identifier. -MSISDN: "msisdn-<msisdn>, where <msisdn> shall be formatted according to clause 3.3 of 3GPP TS 23.003 [7] that describes an MSISDN. Pattern: ‘^(msisdn-[0-9]{5,15}|extid-.+@.+|.+)$’ |
GpsiRm |
string |
This data type is defined in the same way as the "Gpsi" data type, but with the OpenAPI "nullable: true" property. |
GroupId |
string |
String identifying a group of devices network internal globally unique ID which identifies a set of IMSIs, as specified in clause 19.9 of 3GPP TS 23.003 [7]. Pattern: ‘^[A-Fa-f0-9]{8}-[0-9]{3}-[0-9]{2,3}-([A-Fa-f0-9][A-Fa-f0-9]){1,10}$’. |
GroupIdRm |
string |
This data type is defined in the same way as the "GroupId" data type, but with the OpenAPI "nullable: true" property. |
ExternalGroupId |
string |
String identifying External Group Identifier that identifies a group made up of one or more subscriptions associated to a group of IMSIs, as specified in clause 19.7.3 of 3GPP TS 23.003 [7]. Pattern: "^extgroupid-[^@]+@[^@]+$" |
ExternalGroupIdRm |
string |
This data type is defined in the same way as the "ExternalGroupId" data type, but with the OpenAPI "nullable: true" property. |
Pei |
string |
String representing a Permanent Equipment Identifier that may contain: – an IMEI or IMEISV, as specified in clause 6.2 of 3GPP TS 23.003 [7]; – a MAC address for a 5G-RG or FN-RG via wireline access, with an indication that this address cannot be trusted for regulatory purpose if this address cannot be used as an Equipment Identifier of the FN-RG, as specified in clause 4.7.7 of 3GPP TS 23.316 [30]. – an IEEE Extended Unique Identifier (EUI-64), for UEs not supporting any 3GPP access technologies, as defined in IEEE "Guidelines for Use of Extended Unique Identifier (EUI), Organizationally Unique Identifier (OUI), and Company ID (CID)" [38]. Pattern: ‘^(imei-[0-9]{15}|imeisv-[0-9]{16}|mac((-[0-9a-fA-F]{2}){6})(-untrusted)?|eui((-[0-9a-fA-F]{2}){8})|.+)$’. See NOTE 1. Examples: imei-012345678901234 imeisv-0123456789012345 mac-00-00-5E-00-53-00 mac-00-00-5E-00-53-00-untrusted eui-AC-DE-48-23-45-67-01-9F |
PeiRm |
string |
This data type is defined in the same way as the "Pei" data type, but with the OpenAPI "nullable: true" property. |
Supi |
string |
String identifying a Supi that shall contain either an IMSI, a network specific identifier, a Global Cable Identifier (GCI) or a Global Line Identifier (GLI) as specified in clause 2.2A of 3GPP TS 23.003 [7]. It shall be formatted as follows: – for an IMSI "imsi-<imsi>", where <imsi> shall be formatted according to clause 2.2 of 3GPP TS 23.003 [7] that describes an IMSI. – for a network specific identifier "nai-<nai>, where <nai> shall be formatted according to clause 28.7.2 of 3GPP TS 23.003 [7] that describes an NAI. – for a GCI: "gci-<gci>", where <gci> shall be formatted according to clause 28.15.2 of 3GPP TS 23.003 [7]. – for a GLI: "gli-<gli>", where <gli> shall be formatted according to clause 28.16.2 of 3GPP TS 23.003 [7]. To enable that the value is used as part of an URI, the string shall only contain characters allowed according to the "lower-with-hyphen" naming convention defined in 3GPP TS 29.501 [2]. Pattern: ‘^(imsi-[0-9]{5,15}|nai-.+| gci-.+|gli-.+|.+)$’ (NOTE 1). |
SupiRm |
string |
This data type is defined in the same way as the "Supi" data type, but with the OpenAPI "nullable: true" property. |
NfInstanceId |
string |
String uniquely identifying a NF instance. The format of the NF Instance ID shall be a Universally Unique Identifier (UUID) version 4, as described in IETF RFC 4122 [15]. (NOTE 3) |
AmfId |
string |
String identifying the AMF ID composed of AMF Region ID (8 bits), AMF Set ID (10 bits) and AMF Pointer (6 bits) as specified in clause 2.10.1 of 3GPP TS 23.003 [7]. It is encoded as a string of 6 hexadecimal characters (i.e., 24 bits). Pattern: ‘^[A-Fa-f0-9]{6}$’ |
AmfRegionId |
string |
String identifying the AMF Region ID (8 bits), as specified in clause 2.10.1 of 3GPP TS 23.003 [7]. It is encoded as a string of 2 hexadecimal characters (i.e. 8 bits). Pattern: ‘^[A-Fa-f0-9]{2}$’ |
AmfSetId |
string |
String identifying the AMF Set ID (10 bits) as specified in clause 2.10.1 of 3GPP TS 23.003 [7]. It is encoded as a string of 3 hexadecimal characters where the first character is limited to values 0 to 3 (i.e. 10 bits). Pattern: ‘^[0-3][A-Fa-f0-9]{2}$’ |
RfspIndex |
integer |
Unsigned integer representing the "Subscriber Profile ID for RAT/Frequency Priority" as specified in 3GPP TS 36.413 [16]. Minimum = 1. Maximum = 256. |
RfspIndexRm |
integer |
This data type is defined in the same way as the "RfspIndex" data type, but with the OpenAPI "nullable: true" property. |
NfGroupId |
string |
Identifier of a group of NFs |
MtcProviderInformation |
string |
String uniquely identifying MTC provider information. |
CagId |
string |
String containing a Closed Access Group Identifier. Pattern: "^[A-Fa-f0-9]{8}$" |
SupiOrSuci |
string |
String identifying a SUPI or a SUCI. Pattern: "^(imsi-[0-9]{5,15}|nai-.+|gli-.+|gci-.+|suci-(0-[0-9]{3}-[0-9]{2,3}|[1-7]-.+)-[0-9]{1,4}-(0-0-.*|[a-fA-F1-9]-([1-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])-[a-fA-F0-9]+)|.+)$" |
NOTE 1: The encoding of 3GPP defined identifiers (e.g. IMSI, NAI, IMEI, GCI, GLI) shall be prefixed with its corresponding prefix (e.g. ‘imsi-‘,’nai-‘, ‘imei-‘, ‘gci-‘, ‘gli-‘). NOTE 2: Whether the Dnn data type contains just the DNN Network Identifier, or the Network Identifier plus the Operator Identifier, shall be documented in each API where this data type is used. NOTE 3: NFs shall be able to receive a NF Instance Id in any UUID format. |
5.3.3 Enumerations
For Data Types related to Subscription, Identification and Numbering, no Enumerations data types are defined in this version of the specification.
5.3.4 Structured Data Types
5.3.4.1 Type: Guami
Table 5.3.4.1-1: Definition of type Guami
Attribute name |
Data type |
P |
Cardinality |
Description |
plmnId |
PlmnIdNid |
M |
1 |
PLMN Identity and Network Identity |
amfId |
AmfId |
M |
1 |
AMF Identity |
5.3.4.2 Type: NetworkId
Table 5.3.4.2-1: Definition of type NetworkId
Attribute name |
Data type |
P |
Cardinality |
Description |
mcc |
Mcc |
C |
0..1 |
Mobile Country Code |
mnc |
Mnc |
C |
0..1 |
Mobile Network Code |
NOTE: At least one MNC or MCC shall be included. |
5.3.4.3 Type: GuamiRm
This data type is defined in the same way as the "Guami" data type, but with the OpenAPI "nullable: true" property.