5.9 Data Types related to MBS
29.5713GPP5G SystemCommon Data Types for Service Based InterfacesRelease 18Stage 3TS
5.9.1 Introduction
This clause defines common data types related to MBS.
5.9.2 Simple Data Types
This clause specifies common simple data types.
Table 5.9.2-1: Simple Data Types
Type Name |
Type Definition |
Description |
AreaSessionId |
Uint16 |
Area Session Identifier used for MBS session with location dependent content. When present, the Area Session ID together with the TMGI uniquely identifies the MBS session in a specific MBS service area. |
MbsFsaId |
string |
MBS Frequency Selection Area ID, for a broadcast MBS session The value of the MbsFsaId shall be encoded in hexadecimal representation. Each character in the string shall take a value of "0" to "9", "a" to "f" or "A" to "F" and shall represent 4 bits. The most significant character representing the 4 most significant bits of the MBS FSA Id shall appear first in the string, and the character representing the 4 least significant bit of the MBS FSA Id shall appear last in the string. Pattern: ‘^[A-Fa-f0-9]{6}$’ |
5.9.3 Enumerations
5.9.3.1 Enumeration: MbsServiceType
The enumeration MbsServiceType indicates the type of MBS session. It shall comply with the provisions defined in Table 5.9.3.1-1.
Table 5.9.3.1-1: Enumeration MbsServiceType
Enumeration value |
Description |
Applicability |
"MULTICAST" |
Multicast MBS session |
|
"BROADCAST" |
Broadcast MBS session |
5.9.3.2 Enumeration: MbsSessionActivityStatus
The enumeration MbsSessionActivityStatus indicates the MBS session’s activity status. It shall comply with the provisions defined in Table 5.9.3.2-1.
Table 5.9.3.2-1: Enumeration MbsSessionActivityStatus
Enumeration value |
Description |
Applicability |
"ACTIVE" |
Active MBS session |
|
"INACTIVE" |
Inactive MBS session |
5.9.3.3 Enumeration: MbsSessionEventType
Table 5.9.3.3-1: Enumeration MbsSessionEventType
Enumeration value |
Description |
Applicability |
"MBS_REL_TMGI_EXPIRY" |
Subscription to be notified or notification request about the MBS session release due to TMGI expiry. |
|
"BROADCAST_DELIVERY_STATUS" |
Subscription to be notified or notification request about the MBS session broadcast delivery status. |
|
"INGRESS_TUNNEL_ADD_CHANGE" |
Subscription to be notified or notification request about change of the Ingress Tunnel Address, when using unicast transport over N6mb/Nmb9. |
5.9.3.4 Enumeration: BroadcastDeliveryStatus
Table 5.9.3.4-1: Enumeration BroadcastDeliveryStatus
Enumeration value |
Description |
Applicability |
"STARTED" |
The MBS session has been started. |
|
"TERMINATED" |
The MBS session has been terminated. |
5.9.4 Structured Data Types
5.9.4.1 Type: MbsSessionId
Table 5.9.4.1-1: Definition of type MbsSessionId
Attribute name |
Data type |
P |
Cardinality |
Description |
tmgi |
Tmgi |
C |
0..1 |
TMGI identifying the MBS session (NOTE) |
ssm |
Ssm |
C |
0..1 |
Source specific IP multicast address identifying the MBS session (NOTE) |
nid |
Nid |
O |
0..1 |
Network Identity used together with the TMGI to identify an MBS session in an SNPN |
NOTE: At least one of the tmgi IE and ssm IE shall be present. |
5.9.4.2 Type: Tmgi
Table 5.9.4.2-1: Definition of type Tmgi
Attribute name |
Data type |
P |
Cardinality |
Description |
mbsServiceId |
string |
M |
1 |
MBS Service ID consisting of a 6-digit fixed-length hexadecimal number between 000000 and FFFFFF. Each character in the string shall take a value of "0" to "9", "a" to "f" or "A" to "F" and shall represent 4 bits. The most significant character representing the 4 most significant bits of the MBS Service ID shall appear first in the string, and the character representing the 4 least significant bit of the MBS Service ID shall appear last in the string. Pattern: ‘^[A-Fa-f0-9]{6}$’ |
plmnId |
PlmnId |
M |
1 |
PLMN ID |
5.9.4.3 Type: Ssm
Table 5.9.4.3-1: Definition of type Ssm
Attribute name |
Data type |
P |
Cardinality |
Description |
sourceIpAddr |
IpAddr |
M |
1 |
IP unicast address used as source address in IP packets for identifying the source of the multicast service (e.g. AF/AS). |
destIpAddr |
IpAddr |
M |
1 |
IP multicast address used as destination address in related IP packets for identifying the multicast service associated with the source. |
5.9.4.4 Type: MbsServiceArea
Table 5.9.4.4-1: Definition of type MbsServiceArea
Attribute name |
Data type |
P |
Cardinality |
Description |
ncgiList |
array(NcgiTai) |
C |
1..N |
List of NR cell ids with their pertaining TAIs (NOTE). |
taiList |
array(Tai) |
C |
1..N |
List of tracking area Ids (NOTE). |
NOTE: The MBS Service Area consists of the union of the cells in the tracking areas listed in the taiList IE and the cells listed in the ncgiList IE. At least one of the ncgiList IE and taiList IE shall be present. |
5.9.4.5 Type: NcgiTai
Table 5.9.4.5-1: Definition of type NcgiTai
Attribute name |
Data type |
P |
Cardinality |
Description |
tai |
Tai |
M |
1 |
TAI of the cells in cellList (NOTE) |
cellList |
array(Ncgi) |
M |
1..N |
List of NR cell ids |
NOTE: The NcgiTai consists of the list of cells listed in the cellList IE. These cells pertain to the TAI indicated in the tai IE. The TAI may be used e.g. to discover and select an AMF that serves NG-RAN nodes supporting the corresponding cells. |
5.9.4.6 Type: MbsSession
Table 5.9.4.6-1: Definition of type MbsSession
Attribute name |
Data type |
P |
Cardinality |
Description |
mbsSessionId |
MbsSessionId |
C |
0..1 |
MBS session identifier (TMGI and/or SSM, and NID for an SNPN) (NOTE 1) |
tmgiAllocReq |
boolean |
C |
0..1 |
TMGI allocation request indication. This IE shall be present if the mbsSessionId IE is absent. This IE may also be present if the mbsSessionId IE is present and it does not contain a TMGI. When present, it shall be set as follows: – true: a TMGI is requested to be allocated – false (default): no TMGI is requested to be allocated Write-Only: true (NOTE 1) |
tmgi |
Tmgi |
C |
0..1 |
This IE shall be present in an MBS session creation response if the tmgiAllocReq IE was present and set to "true" in the MBS session creation request. When present, it shall indicate the TMGI allocated to the MBS session. Read-Only: true |
expirationTime |
DateTime |
C |
0..1 |
This IE shall be present in an MBS session creation response if the tmgiAllocReq IE was present and set to "true" in the in the MBS session creation request. When present, it shall indicate the expiration time for the TMGI allocated to the MBS session. Read-Only: true |
serviceType |
MbsServiceType |
M |
1 |
MBS Service Type (either multicast or broadcast service) Write-Only: true |
locationDependent |
boolean |
C |
0..1 |
Location dependent MBS session indication. This IE shall be present and set to true for a Location dependent MBS session. It may be present otherwise. When present, it shall be set as follows: – true: this is a Location dependent MBS session – false (default): this is not a Location dependent MBS session |
areaSessionId |
AreaSessionId |
C |
0..1 |
This IE shall be present in a successful response to a request to create an instance of a Location dependent MBS session i.e. when the "locationDependent" attribute is present and set to "true" in the MBS session creation request. When present, it shall contain the Area Session ID assigned by the MB-SMF to the location dependent MBS session instance in the MBS Service Area. Read-Only: true |
ingressTunAddrReq |
boolean |
O |
0..1 |
Ingress transport address request indication (for unicast transport over N6mb/Nmb9). When present, it shall be set as follows: – true: an ingress transport address is requested – false (default): no request Write-Only: true |
ingressTunAddr |
array(TunnelAddress) |
C |
1..N |
Ingress tunnel address (UDP/IP tunnel). This IE shall be present in an MBS session creation response if the ingressTunAddrReq IE was present and set to "true" in the corresponding MBS session creation request. When present, it shall indicate the allocated ingress tunnel address(es). Read-Only: true (NOTE 2) |
ssm |
Ssm |
C |
0..1 |
Source specific IP multicast address This IE shall be present if multicast transport applies over N6mb and the MBS session is not identified by the SSM, e.g. for a location-dependent MBS session with multicast transport over N6mb. Write-Only: true |
mbsServiceArea |
MbsServiceArea |
O |
0..1 |
Contains the MBS Service Area This attribute shall be present only for a location dependent MBS session or a local MBS session. Write-Only: true |
extMbsServiceArea |
ExternalMbsServiceArea |
O |
0..1 |
Contains the MBS service area. This attribute shall be present only for a location dependent MBS session or a local MBS session. This IE may be present only over the N33 and Nmb10 interfaces; it shall not be present over other interfaces. When present, it shall indicate the MBS Service Area information which shall either be geographical area information or civic address information. Write-Only: true |
dnn |
Dnn |
O |
0..1 |
Represents the DNN Write-Only: true |
snssai |
Snssai |
O |
0..1 |
Represents the S-NSSAI Write-Only: true |
activationTime |
DateTime |
O |
0..1 |
Represents the MBS session start time. This attribute is deprecated and replaced by the "startTime" attribute. |
startTime |
DateTime |
O |
0..1 |
Represents the MBS session start time. |
terminationTime |
DateTime |
O |
0..1 |
Represents the MBS session termination time. |
mbsServInfo |
MbsServiceInfo |
O |
0..1 |
Contains the MBS Service Information for the MBS session. |
mbsSessionSubsc |
MbsSessionSubscription |
O |
0..1 |
Contains the parameters to request the creation of a subscription to one or more MBS session status event(s). |
activityStatus |
MbsSessionActivityStatus |
O |
0..1 |
Contains the session activity status (active or inactive). This IE may be provided if the "serviceType" attribute indicates a multicast MBS session. |
anyUeInd |
boolean |
O |
0..1 |
Indication that any UE may join the MBS session. This IE may be provided if the "serviceType" attribute indicates a multicast MBS session. When present, it shall be set as follows: – true: any UE may join the MBS session – false (default): the MBS session is not open to any UE Write-Only: true |
mbsFsaIdList |
array(MbsFsaId) |
O |
1..N |
List of MBS Frequency Selection Area Identifiers, for a broadcast MBS session. This attribute may be present if the "serviceType" attribute indicates a broadcast MBS session. |
NOTE 1: At least one of the mbsSessionId IE and tmgiAllocReq IE shall be present. Both may be present if the mbsSessionId IE does not contain a TMGI (i.e. if it only contains a SSM). NOTE 2: In a scenario where an MB-UPF covers a small service area (i.e. a list of TAIs that is a subset of the MBS service area), the MB-SMF needs to find other MB-UPF(s) to cover the whole MBS service area for the MBS session. In such scenarios, multiple ingress addresses of all MB-UPFs need to be allocated for an MBS session. These multiple ingress tunnel addresses are used to receive the same copy of the MBS session data from the AF/MBSTF. In such scenarios, the MBS service area served by an MB-UPF shall be larger than the MBS service area served by an AMF (set), i.e. an AMF in an AMF set shall receive only one MBS Session Information Request Transfer for an MBS session in the MBS Session Context Create/Update Request message. |
5.9.4.7 Type: MbsSessionSubscription
Table 5.9.4.7-1: Definition of type MbsSessionSubscription
Attribute name |
Data type |
P |
Cardinality |
Description |
mbsSessionId |
MbsSessionId |
C |
0..1 |
Identifier of the MBS Session for which the subscription is created. This IE shall be present, except for an MBS session subscription request that is sent within an MBS session creation request. |
areaSessionId |
AreaSessionId |
C |
0..1 |
Area Session ID, for a location dependent MBS session, identifying the part of the MBS session in an MBS service area for which the subscription is created. It shall be present for a location dependent MBS session, except for an MBS session subscription request that is sent within an MBS session creation request |
eventList |
array(MbsSessionEvent) |
M |
1..N |
List of MBS session events subscribed |
notifyUri |
Uri |
M |
1 |
URI where the NF service consumer requests to receive MBS session notifications. Write-Only: true |
notifyCorrelationId |
string |
O |
0..1 |
Notification Correlation ID Write-Only: true |
expiryTime |
DateTime |
O |
0..1 |
When present in an MBS Session subscription creation request, it shall indicate the time up to which the subscription is desired to be kept active and after which the subscribed events shall stop generating notifications. When present in a subscription response, it shall indicate the expiry time after which the subscription becomes invalid. |
nfcInstanceId |
NfInstanceId |
C |
0..1 |
NF Instance ID of the NF Service Consumer This IE shall be present if available. Write-Only: true |
mbsSessionSubscUri |
Uri |
C |
0..1 |
This IE shall be present in the response to an MBS session creation request that includes a subscription to events about the MBS session and the subscription was created successfully. When present, it shall contain the URI of the individual subscription resource. Read-Only: true (NOTE) |
NOTE: When an MBS session status subscription is created separately (i.e. after) an MBS session creation, the Location header returned in the MBS session status subscription creation response contains the URI of the created subscription. |
5.9.4.8 Type: MbsSessionEventReportList
Table 5.9.4.8-1: Definition of type MbsSessionEventReportList
Attribute name |
Data type |
P |
Cardinality |
Description |
eventReportList |
array(MbsSessionEventReport) |
M |
1..N |
List of MBS session events to report |
notifyCorrelationId |
string |
C |
0..1 |
Notification Correlation ID. This IE shall be present if a Notification Correlation ID is available in the subscription. |
5.9.4.9 Type: MbsSessionEvent
Table 5.9.4.9-1: Definition of type MbsSessionEvent
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
eventType |
MbsSessionEventType |
M |
1 |
MBS session event type |
5.9.4.10 Type: MbsSessionEventReport
Table 5.9.4.10-1: Definition of type MbsSessionEventReport
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
eventType |
MbsSessionEventType |
M |
1 |
MBS session event type |
|
timeStamp |
DateTime |
C |
0..1 |
This IE shall contain the time at which the event is generated. This IE should be present, if available. |
|
ingressTunAddrInfo |
IngressTunAddrInfo |
C |
0..1 |
This IE shall be present if the eventType IE indicates "INGRESS_TUNNEL_ADD_CHANGE". |
|
broadcastDelStatus |
BroadcastDeliveryStatus |
C |
0..1 |
This IE shall be present if the eventType IE indicates "BROADCAST_DELIVERY_STATUS". |
5.9.4.11 Type: ExternalMbsServiceArea
Table 5.9.4.11-1: Definition of type ExternalMbsServiceArea
Attribute name |
Data type |
P |
Cardinality |
Description |
geographicAreaList |
array(GeographicArea) |
C |
1..N |
Identifies a list of geographic area specified by different shapes. |
civicAddressList |
array(CivicAddress) |
C |
1..N |
Identifies a list of civic address. |
NOTE: Either the geographicAreaList IE or the civicAddressList IE shall be present. |
5.9.4.12 Type: MbsSecurityContext
Table 5.9.4.12-1: Definition of type MbsSecurityContext
Attribute name |
Data type |
P |
Cardinality |
Description |
keyList |
map(MbsKeyInfo) |
M |
1..N |
One or more MSK/MTK(s) and associated IDs. The key of the map shall be a (unique) valid JSON string per clause 7 of IETF RFC 8259 [22], with a maximum of 32 characters |
5.9.4.13 Type: MbsKeyInfo
Table 5.9.4.13-1: Definition of type MbsSecurityContext
Attribute name |
Data type |
P |
Cardinality |
Description |
keyDomainId |
Bytes |
M |
1 |
Key Domain ID = MCC || MNC as defined in 3GPP TS 33.246 [45]. (NOTE) It shall be encoded as a string with format "byte" as defined in OpenAPI Specification [3], i.e. base64-encoded characters, representing the Key Domain ID (encoded in 3 bytes). |
mskID |
Bytes |
M |
1 |
MSK ID as defined in 3GPP TS 33.246 [45]. It shall be encoded as a string with format "byte" as defined in OpenAPI Specification [3], i.e. base64-encoded characters, representing the MSK ID (encoded in 4 bytes). |
msk |
Bytes |
C |
0..1 |
MSK as defined in 3GPP TS 33.246 [45]. The IE shall not be present when MBSTF requests updated MSK from MBSF after, e.g. lifetime expiry. Shall be present otherwise. When present, it shall be encoded as a string with format "byte" as defined in OpenAPI Specification [3], i.e. base64-encoded characters, representing the MSK (encoded in 16 bytes). |
mskLifetime |
DateTime |
O |
0..1 |
MSK Lifetime as defined in 3GPP TS 33.501 [46]. |
mtkID |
Bytes |
C |
0..1 |
MTK ID as defined in 3GPP TS 33.246 [45]. Shall be present if available. It shall be encoded as a string with format "byte" as defined in OpenAPI Specification [3], i.e. base64-encoded characters, representing the MTK ID (encoded in 2 bytes). |
mtk |
Bytes |
C |
0..1 |
MTK as defined in 3GPP TS 33.246 [45]. Shall be present if available. It shall be encoded as a string with format "byte" as defined in OpenAPI Specification [3], i.e. base64-encoded characters, representing the MTK (encoded in 16 bytes). |
NOTE: For a multicast MBS session in a SNPN, the Key Domain ID for the MBS session should be encoded using MCC and MNC, in this case, it may not be unique. |
5.9.4.14 Type: IngressTunAddrInfo
Table 5.9.4.14-1: Definition of type IngressTunAddrInfo
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
ingressTunAddr |
array(TunnelAddress) |
M |
1..N |
Ingress Tunnel Address(es) to use to send MBS session data over N6mb/Nmb9 and that replace any earlier provided Ingress Tunnel Address(es). |
5.9.4.15 Type: MbsServiceAreaInfo
Table 5.9.4.15-1: Definition of type MbsServiceAreaInfo
Attribute name |
Data type |
P |
Cardinality |
Description |
areaSessionId |
AreaSessionId |
M |
1 |
Area Session Identifier used for MBS session with location dependent content. |
mbsServiceArea |
MbsServiceArea |
M |
1 |
MBS Service Area for MBS session with location dependent content. |
5.9.4.16 Type: MbsServiceInfo
Table 5.9.4.16-1: Definition of type MbsServiceInfo
Attribute name |
Data type |
P |
Cardinality |
Description |
mbsMediaComps |
map(MbsMediaCompRm) |
M |
1..N |
Contains the information of one or several media component(s). The key of the map is the "medCompN" attribute of the corresponding MbsMediaComRm data structure provided as a map entry. |
mbsSdfResPrio |
ReservPriority |
O |
0..1 |
Indicates the reservation priority of the MBS service data flow(s) identified by the "mbsMediaComps" attribute. |
afAppId |
AfAppId |
O |
0..1 |
Contains the AF application identifier. |
mbsSessionAmbr |
BitRate |
O |
0..1 |
Contains the required MBS Session-AMBR. |
5.9.4.17 Type: MbsMediaComp
Table 5.9.4.17-1: Definition of type MbsMediaComp
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
mbsMedCompNum |
integer |
M |
1 |
Contains the ordinal number of the MBS media component. |
|
mbsFlowDescs |
array(FlowDescription) |
O |
1..N |
Contains the flow description for the MBS Downlink IP flow(s). |
|
mbsSdfResPrio |
ReservPriority |
O |
0..1 |
Indicates the reservation priority for the MBS service data flow(s) identified by the "mbsFlowDescs" attribute. (NOTE 2) |
|
mbsMediaInfo |
MbsMediaInfo |
O |
0..1 |
Indicates the MBS media information. (NOTE 1) |
|
qosRef |
string |
O |
0..1 |
Contains the identifier to pre-defined MBS QoS. (NOTE 1) |
|
mbsQoSReq |
MbsQoSReq |
O |
0..1 |
Contains the MBS QoS requirements. (NOTE 1) |
|
NOTE 1: Only one of these attributes may be present. NOTE 2: When present, the value of this attribute shall apply for the MBS service data flow(s) identified by this MBS Media Component. It shall take precedence over the value of the same attribute within the parent MbsServiceInfo data structure. |
5.9.4.18 Type: MbsMediaCompRm
This data type is defined in the same way as the MediaComponent data type defined in clause 5.9.4.17, but with the OpenAPI "nullable: true" property.
5.9.4.19 Type: MbsQoSReq
Table 5.9.4.19-1: Definition of type MbsQoSReq
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
---|---|---|---|---|---|
5qi |
5Qi |
M |
1 |
Represents the required 5QI. |
|
guarBitRate |
BitRate |
O |
0..1 |
Contain the required 5GS guaranteed bit rate. |
|
maxBitRate |
BitRate |
O |
0..1 |
Contain the required 5GS maximum bit rate. |
|
averWindow |
AverWindow |
C |
0..1 |
Indicates the averaging window. This attribute shall be present only for a GBR QoS flow or a Delay Critical GBR QoS flow. |
|
reqMbsArp |
Arp |
O |
1 |
Indicates the requested allocation and retention priority. |
5.9.4.20 Type: MbsMediaInfo
Table 5.9.4.20-1: Definition of type MbsMediaInfo
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
---|---|---|---|---|---|
mbsMedType |
MediaType |
O |
0..1 |
Indicates the MBS media type. |
|
maxReqMbsBwDl |
BitRate |
O |
0..1 |
Contains the Maximum requested bandwidth. |
|
minReqMbsBwDl |
BitRate |
O |
0..1 |
Contains the Minimum requested bandwidth. |
|
codecs |
array(CodecData) |
O |
1..2 |
Indicates the codec data. |
Annex A (normative):
OpenAPI specification