6 API Definitions
29.5813GPP5G SystemMulticast/Broadcast Service Transport ServicesRelease 17Stage 3TS
6.1 Nmbstf_MBSDistributionSession Service API
6.1.1 Introduction
The Nmbstf_MBSDistributionSession service shall use the Nmbstf-distsession API.
The API URI of the Nmbstf_MBSDistributionSession API shall be:
{apiRoot}/<apiName>/<apiVersion>
The request URIs used in HTTP requests from the NF service consumer towards the NF service producer shall have the Resource URI structure defined in clause 4.4.1 of 3GPP TS 29.501 [5], i.e.:
{apiRoot}/<apiName>/<apiVersion>/<apiSpecificResourceUriPart>
with the following components:
– The {apiRoot} shall be set as described in 3GPP TS 29.501 [5].
– The <apiName> shall be "nmbstf-distsession".
– The <apiVersion> shall be "v1".
– The <apiSpecificResourceUriPart> shall be set as described in clause 6.1.3.
6.1.2 Usage of HTTP
6.1.2.1 General
HTTP/2, IETF RFC 7540 [11], shall be used as specified in clause 5 of 3GPP TS 29.500 [4].
HTTP/2 shall be transported as specified in clause 5.3 of 3GPP TS 29.500 [4].
The OpenAPI [6] specification of HTTP messages and content bodies for the Nmbstf-distsession API is contained in Annex A.
6.1.2.2 HTTP standard headers
6.1.2.2.1 General
See clause 5.2.2 of 3GPP TS 29.500 [4] for the usage of HTTP standard headers.
6.1.2.2.2 Content type
JSON, IETF RFC 8259 [12], shall be used as content type of the HTTP bodies specified in the present specification as specified in clause 5.4 of 3GPP TS 29.500 [4]. The use of the JSON format shall be signalled by the content type "application/json".
"Problem Details" JSON object shall be used to indicate additional details of the error in a HTTP response body and shall be signalled by the content type "application/problem+json", as defined in IETF RFC 7807 [13].
6.1.2.3 HTTP custom headers
The mandatory HTTP custom header fields specified in clause 5.2.3.2 of 3GPP TS 29.500 [4] shall be supported, and the optional HTTP custom header fields specified in clause 5.2.3.3 of 3GPP TS 29.500 [4] may be supported.
6.1.3 Resources
6.1.3.1 Overview
Figure 6.1.3.1-1 describes the resource URI structure of the Nmbstf_MBSDistributionSession API.
Figure 6.1.3.1-1: Resource URI structure of the Nmbstf_MBSDistributionSession API
Table 6.1.3.1-1 provides an overview of the resources and applicable HTTP methods.
Table 6.1.3.1-1: Resources and methods overview
Resource purpose/name |
Resource URI (relative path after API URI) |
HTTP method or custom operation |
Description (service operation) |
MBS Distribution sessions collection |
/dist-sessions |
POST |
Create |
Individual MBS Distribution session |
/dist-sessions/{distSessionRef} |
PATCH |
Update |
GET |
Retrieve |
||
DELETE |
Destroy |
||
Subscriptions collection for MBS Distribution sessions |
/dist-sessions/{distSessionRef}/subscriptions |
POST |
StatusSubscribe (to create a subscription) |
Individual subscription for an MBS Distribution session |
/dist-sessions/{distSessionRef}/subscriptions/{subscriptionId} |
DELETE |
StatusUnsubscribe |
PATCH |
StatusSubscribe (to update or renew a subscription) |
6.1.3.2 Resource: MBS Distribution sessions collection (Collection)
6.1.3.2.1 Description
This resource represents the collection of the MBS Distribution sessions created in the MBSTF.
This resource is modelled with the Collection resource archetype (see clause C.2 of 3GPP TS 29.501 [5]).
6.1.3.2.2 Resource Definition
Resource URI: {apiRoot}/nmbstf-distSession/<apiVersion>/dist-sessions
This resource shall support the resource URI variables defined in table 6.1.3.2.2-1.
Table 6.1.3.2.2-1: Resource URI variables for this resource
Name |
Data type |
Definition |
apiRoot |
string |
See clause 6.1.1 |
apiVersion |
string |
See clause 6.1.1 |
6.1.3.2.3 Resource Standard Methods
6.1.3.2.3.1 POST
This method creates an individual MBS distribution session resource in the MBSTF.
This method shall support the URI query parameters specified in table 6.1.3.2.3.1-1.
Table 6.1.3.2.3.1-1: URI query parameters supported by the POST method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.1.3.2.3.1-2 and the response data structures and response codes specified in table 6.1.3.2.3.1-3.
Table 6.1.3.2.3.1-2: Data structures supported by the POST Request Body on this resource
Data type |
P |
Cardinality |
Description |
CreateReqData |
M |
1 |
Representation of the MBS distribution session to be created in the MBSTF |
Table 6.1.3.2.3.1-3: Data structures supported by the POST Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
CreateRspData |
M |
1 |
201 Created |
Successful creation of an MBS session |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
NOTE 1: The mandatory HTTP error status code for the POST method listed in Table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply. NOTE 2: RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of 3GPP TS 29.500 [4]. |
Table 6.1.3.2.3.1-4: Headers supported by the POST method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Table 6.1.3.2.3.1-5: 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}/nmbstf-distSession/<apiVersion>/dist-sessions/{distSessionRef} |
Table 6.1.3.2.3.1-6: Headers supported by the 307 response code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
Table 6.1.3.2.3.1-7: Headers supported by the 308 response code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
6.1.3.2.4 Resource Custom Operations
None
6.1.3.3 Resource: Individual MBS distribution session (Document)
6.1.3.3.1 Description
This resource represents an individual MBS distribution session created in the MBSTF.
This resource is modelled with the Document resource archetype (see clause C.1 of 3GPP TS 29.501 [5]).
6.1.3.3.2 Resource Definition
Resource URI: {apiRoot}/nmbstf-distSession/<apiVersion>/dist-sessions/{distSessionRef}
This resource shall support the resource URI variables defined in table 6.1.3.3.2-1.
Table 6.1.3.3.2-1: Resource URI variables for this resource
Name |
Data type |
Definition |
apiRoot |
String |
See clause 6.1.1 |
apiVersion |
String |
See clause 6.1.1 |
distSessionRef |
String |
MBS distribution session reference assigned by the MBSTF during the Create service operation |
6.1.3.3.3 Resource Standard Methods
6.1.3.3.3.1 PATCH
This method updates an individual MBS distribution session resource in the MBSTF.
This method shall support the URI query parameters specified in table 6.1.3.3.3.1-1.
Table 6.1.3.3.3.1-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.1.3.3.3.1-2 and the response data structures and response codes specified in table 6.1.3.3.3.1-3.
Table 6.1.3.3.3.1-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1 |
List of changes to be made to the MBS session resource, according to the JSON PATCH format specified in IETF RFC 6902 [16]. |
Table 6.1.3.3.3.1-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 response |
||
DistSession |
M |
1 |
200 OK |
Upon success, a response body containing the updated representation of Distribution Session shall be returned |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
NOTE 1: The mandatory HTTP error status code for the PATCH method listed in Table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply. NOTE 2: RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of 3GPP TS 29.500 [4]. |
Table 6.1.3.3.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
String |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
String |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
Table 6.1.3.3.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
6.1.3.3.3.2 DELETE
This method deletes an individual MBS distribution session resource in the MBSTF.
This method shall support the URI query parameters specified in table 6.1.3.3.3.2-1.
Table 6.1.3.3.3.2-1: URI query parameters supported by the DELETE method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.1.3.3.3.2-2 and the response data structures and response codes specified in table 6.1.3.3.3.2-3.
Table 6.1.3.3.3.2-2: Data structures supported by the DELETE Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.1.3.3.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 response |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
NOTE 1: The mandatory HTTP error status code for the DELETE method listed in Table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply. NOTE 2: RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of 3GPP TS 29.500 [4]. |
Table 6.1.3.3.3.2-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
Table 6.1.3.3.3.2-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MB-STF (service) instance ID towards which the request is redirected |
6.1.3.3.3.3 GET
This method retrieves an individual MBS distribution session resource in the MBSTF.
This method shall support the URI query parameters specified in table 6.1.3.3.3.3-1.
Table 6.1.3.3.3.3-1: URI query parameters supported by the GET method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.1.3.3.3.3-2 and the response data structures and response codes specified in table 6.1.3.3.3.3-3.
Table 6.1.3.3.3.3-2: Data structures supported by the GET Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.1.3.3.3.3-3: Data structures supported by the GET Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
DistSession |
M |
1 |
200 OK |
Successful response containing representation of the MBS Distribution Session |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
NOTE 1: The mandatory HTTP error status code for the GET method listed in Table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply. NOTE 2: RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of 3GPP TS 29.500 [4]. |
Table 6.1.3.3.3.3-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
Table 6.1.3.3.3.3-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
6.1.3.3.4 Resource Custom Operations
None.
6.1.3.4 Resource: Subscriptions collection for MBS distribution session (Collection)
6.1.3.4.1 Description
This resource represents the collection of the individual subscriptions for an MBS distribution session created in the MBSTF with StatusSubscribe service operation.
This resource is modelled with the Collection resource archetype (see clause C.2 of 3GPP TS 29.501 [5]).
6.1.3.4.2 Resource Definition
Resource URI: {apiRoot}/nmbstf-distSession/<apiVersion>/dist-sessions/{distSessionRef}/subscriptions
This resource shall support the resource URI variables defined in table 6.1.3.4.2-1.
Table 6.1.3.4.2-1: Resource URI variables for this resource
Name |
Data type |
Definition |
apiRoot |
string |
See clause 6.1.1 |
apiVersion |
string |
See clause 6.1.1 |
distSessionRef |
string |
MBS distribution session reference assigned by the MBSTF during the Create service operation |
6.1.3.4.3 Resource Standard Methods
6.1.3.4.3.1 POST
This method creates an individual subscription resource for an MBS distribution session in the MBSTF with StatusSubscribe service operation.
This method shall support the URI query parameters specified in table 6.1.3.4.3.1-1.
Table 6.1.3.4.3.1-1: URI query parameters supported by the POST method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.1.3.4.3.1-2 and the response data structures and response codes specified in table 6.1.3.4.3.1-3.
Table 6.1.3.4.3.1-2: Data structures supported by the POST Request Body on this resource
Data type |
P |
Cardinality |
Description |
StatusSubscribeReqData |
M |
1 |
Data within the StatusSubscribe Request |
Table 6.1.3.4.3.1-3: Data structures supported by the POST Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
StatusSubscribeRspData |
M |
1 |
201 Created |
Data within the StatusSubscribe Response |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
NOTE 1: The mandatory HTTP error status code for the POST method listed in Table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply. NOTE 2: RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of 3GPP TS 29.500 [4]. |
Table 6.1.3.4.3.1-4: Headers supported by the POST method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Table 6.1.3.4.3.1-5: 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}/nmbstf-distSession/<apiVersion>/dist-sessions/{distSessionRef}/subscriptions/{subscriptionId} |
Table 6.1.3.4.3.1-6: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
Table 6.1.3.4.3.1-7: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
6.1.3.4.4 Resource Custom Operations
None.
6.1.3.5 Resource: Individual subscription for an MBS distribution session (Document)
6.1.3.5.1 Description
This resource represents an individual subscription for an MBS distribution session in the MBSTF, which can be deleted with StatusUnsubscribe service operation or updated with StatusSubscribe service operation.
This resource is modelled with the Document resource archetype (see clause C.1 of 3GPP TS 29.501 [5]).
6.1.3.5.2 Resource Definition
Resource URI: {apiRoot}/nmbstf-distsession/<apiVersion>/dist-sessions/{distSessionRef}/subscriptions/{subscriptionId}
This resource shall support the resource URI variables defined in table 6.1.3.5.2-1.
Table 6.1.3.5.2-1: Resource URI variables for this resource
Name |
Data type |
Definition |
apiRoot |
string |
See clause 6.1.1 |
apiVersion |
string |
See clause 6.1.1 |
distSessionRef |
string |
MBS distribution session reference assigned by the MBSTF during the Create service operation |
subscriptionId |
string |
Subscription identifier assigned by the MBSTF during the creation of the subscription |
6.1.3.5.3 Resource Standard Methods
6.1.3.5.3.1 DELETE
This method deletes an individual subscription resource for an MBS distribution session in the MBSTF with StatusUnsubscribe service operation.
This method shall support the URI query parameters specified in table 6.1.3.5.3.1-1.
Table 6.1.3.5.3.1-1: URI query parameters supported by the DELETE method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.1.3.5.3.1-2 and the response data structures and response codes specified in table 6.1.3.5.3.1-3.
Table 6.1.3.5.3.1-2: Data structures supported by the DELETE Request Body on this resource
Data type |
P |
Cardinality |
Description |
n/a |
Table 6.1.3.5.3.1-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 deletion |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
NOTE 1: The mandatory HTTP error status code for the POST method listed in Table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply. NOTE 2: RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of 3GPP TS 29.500 [4]. |
Table 6.1.3.5.3.1-4: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
Table 6.1.3.5.3.1-5: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
6.1.3.5.3.2 PATCH
This method updates an individual subscription resource for an MBS distribution session in the MBSTF with StatusSubscribe service operation for the subscription update (see clause 5.2.2.6.3).
This method shall support the URI query parameters specified in table 6.1.3.5.3.2-1.
Table 6.1.3.5.3.2-1: URI query parameters supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Applicability |
n/a |
This method shall support the request data structures specified in table 6.1.3.5.3.2-2 and the response data structures and response codes specified in table 6.1.3.5.3.2-3.
Table 6.1.3.5.3.2-2: Data structures supported by the PATCH Request Body on this resource
Data type |
P |
Cardinality |
Description |
array(PatchItem) |
M |
1 |
It shall contain the list of changes to be made to the Status Subscription (i.e. DistSessionSubscription data type), according to the JSON PATCH format specified in IETF RFC 6902 [16]. |
Table 6.1.3.5.3.2-3: Data structures supported by the PATCH Response Body on this resource
Data type |
P |
Cardinality |
Response codes |
Description |
DistSessionSubscription |
M |
1 |
200 OK |
Upon success, a response body shall be returned containing the updated Status Subscription. |
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The response shall include a Location header field containing a different URI, or the same URI if a request is redirected to the same target resource via a different SCP. In the former case, the URI shall be an alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. (NOTE 2) |
NOTE 1: The mandatory HTTP error status code for the POST method listed in Table 5.2.7.1-1 of 3GPP TS 29.500 [4] also apply. NOTE 2: RedirectResponse may be inserted by an SCP, see clause 6.10.9.1 of 3GPP TS 29.500 [4]. |
Table 6.1.3.5.3.2-4: Headers supported by the PATCH method on this resource
Name |
Data type |
P |
Cardinality |
Description |
Table 6.1.3.5.3.2-5: Headers supported by the 200 response code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Table 6.1.3.5.3.2-6: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
Table 6.1.3.5.3.2-7: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
An alternative URI of the resource located on an alternative service instance within the same MBSTF or MBSTF (service) set. Or the same URI, if a request is redirected to the same target resource via a different SCP. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target MBSTF (service) instance ID towards which the request is redirected |
6.1.3.5.4 Resource Custom Operations
None.
6.1.4 Custom Operations without associated resources
None
6.1.5 Notifications
6.1.5.1 General
Notifications shall comply to clause 6.2 of 3GPP TS 29.500 [4] and clause 4.6.2.3 of 3GPP TS 29.501 [5].
Table 6.1.5.1-1: Notifications overview
Notification |
Callback URI |
HTTP method or custom operation |
Description (service operation) |
Event Notification |
NotifUri |
POST |
StatusNotify |
6.1.5.2 StatusNotify
6.1.5.2.1 Description
The Event Notification is used by the NF service producer to report one or several observed Events to a NF service consumer that has subscribed to such Notifications.
6.1.5.2.2 Target URI
The Callback URI "{notifUri}" shall be used with the callback URI variables defined in table 6.1.5.2.2-1.
Table 6.1.5.2.2-1: Callback URI variables
Name |
Definition |
notifUri |
String formatted as URI with the Callback Uri |
6.1.5.2.3 Standard Methods
6.1.5.2.3.1 POST
This method shall support the request data structures specified in table 6.1.5.2.3.1-1 and the response data structures and response codes specified in table 6.1.5.2.3.1-2.
Table 6.1.5.2.3.1-1: Data structures supported by the POST Request Body
Data type |
P |
Cardinality |
Description |
StatusNotifyReqData |
M |
1 |
Data within the StatusNotify Request |
Table 6.1.5.2.3.1-2: Data structures supported by the POST Response Body
Data type |
P |
Cardinality |
Response codes |
Description |
n/a |
204 No Content |
Successful response |
||
RedirectResponse |
O |
0..1 |
307 Temporary Redirect |
Temporary redirection. The NF service consumer shall generate a Location header field containing a URI pointing to the endpoint of another NF service consumer to which the notification should be sent. If an SCP redirects the message to another SCP then the location header field shall contain the same URI or a different URI pointing to the endpoint of the NF service consumer to which the notification should be sent. |
RedirectResponse |
O |
0..1 |
308 Permanent Redirect |
Permanent redirection. The NF service consumer shall generate a Location header field containing a URI pointing to the endpoint of another NF service consumer to which the notification should be sent. If an SCP redirects the message to another SCP then the location header field shall contain the same URI or a different URI pointing to the endpoint of the NF service consumer to which the notification should be sent. |
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 6.1.5.2.3.1-3: Headers supported by the 307 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
A URI pointing to the endpoint of the NF service consumer to which the notification should be sent |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected |
Table 6.1.5.2.3.1-4: Headers supported by the 308 Response Code on this resource
Name |
Data type |
P |
Cardinality |
Description |
Location |
string |
M |
1 |
A URI pointing to the endpoint of the NF service consumer to which the notification should be sent. |
3gpp-Sbi-Target-Nf-Id |
string |
O |
0..1 |
Identifier of the target NF (service) instance ID towards which the request is redirected |
6.1.6 Data Model
6.1.6.1 General
This clause specifies the application data model supported by the API.
Table 6.1.6.1-1 specifies the data types defined for the Nmbstf_MBSDistributionSession service based interface protocol.
Table 6.1.6.1-1: Nmbstf_MBSDistributionSession specific Data Types
Data type |
Clause defined |
Description |
Applicability |
CreateReqData |
6.1.6.2.2 |
Data within the Create Request |
|
CreateRspData |
6.1.6.2.3 |
Data within the Create Response |
|
DistSession |
6.1.6.2.4 |
Data specific to distribution session |
|
ObjDistributionData |
6.1.6.2.5 |
Data specific to Object Distribution Method |
|
PktDistributionData |
6.1.6.2.6 |
Data specific to Packet Distribution Method |
|
StatusSubscribeReqData |
6.1.6.2.7 |
Data within Subscription creation request |
|
StatusSubscribeRspData |
6.1.6.2.8 |
Data within Subscription creation response |
|
StatusNotifyReqData |
6.1.6.2.9 |
Data within Notification request |
|
DistSessionSubscription |
6.1.6.2.10 |
Data specific to subscription request |
|
DistSessionEventReportList |
6.1.6.2.11 |
MBS distribution session event report list |
|
DistSessionEventReport |
6.1.6.2.12 |
MBS distribution session event report |
|
UpTrafficFlowInfo |
6.1.6.2.13 |
IP Multicast Address and Port Number |
|
MbStfIngestAddr |
6.1.6.2.14 |
MBSTF Ingest Addresses |
|
ExtSsm |
6.1.6.2.15 |
SSM and Port Number |
|
DistSessionState |
6.1.6.3.3 |
MBS distribution session state |
|
ObjDistributionOperatingMode |
6.1.6.3.4 |
Operating Mode for Object distribution method |
|
ObjAcquisitionMethod |
6.1.6.3.5 |
Object acquisition method |
|
PktDistributionOperatingMode |
6.1.6.3.6 |
Operating Mode for Packet distribution method |
|
DistSessionEventType |
6.1.6.3.7 |
MBS distribution session event type |
|
PktIngestMethod |
6.1.6.3.8 |
Packet Ingest Method |
Table 6.1.6.1-2 specifies data types re-used by the Nmbstf_MBSDistributionSession 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 Nmbstf_MBSDistributionSession service based interface.
Table 6.1.6.1-2: Nmbstf_MBSDistributionSession re-used Data Types
Data type |
Reference |
Comments |
Applicability |
TunnelAddress |
3GPP TS 29.571 [16] |
Tunnel Address (UDP/IP) |
|
BitRate |
3GPP TS 29.571 [16] |
Bit Rate |
|
PacketDelBudget |
3GPP TS 29.571 [16] |
Maximum Delay |
|
Uri |
3GPP TS 29.571 [16] |
Uniform resource identifier |
|
DateTime |
3GPP TS 29.571 [16] |
Data and Time |
|
NfInstanceId |
3GPP TS 29.571 [16] |
NF Instance Identifier |
|
Uinteger |
3GPP TS 29.571 [16] |
Unsigned Integer |
|
IpAddr |
3GPP TS 29.571 [16] |
IP Address |
|
Ssm |
3GPP TS 29.571 [16] |
Source Specific Multicast Address |
|
MbsSecurityContext |
3GPP TS 29.571 [16] |
MBS Security Context |
|
FECConfig |
3GPP TS 29.580 [18] |
FEC Configuration |
6.1.6.2 Structured data types
6.1.6.2.1 Introduction
This clause defines the structures to be used in resource representations.
6.1.6.2.2 Type: CreateReqData
Table 6.1.6.2.2-1: Definition of type CreateReqData
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
distSession |
DistSession |
M |
1 |
MBS Distribution Session to be created. |
6.1.6.2.3 Type: CreateRspData
Table 6.1.6.2.3-1: Definition of type CreateRspData
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
distSession |
DistSession |
M |
1 |
Representation of the created MBS session |
6.1.6.2.4 Type: DistSession
Table 6.1.6.2.4-1: Definition of type DistSession
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
distSessionId |
string |
M |
1 |
An identifier for this MBS Distribution Session assigned by the MBSF that is unique within the scope of the MBS User Service (see clause 4.5.3 of 3GPP TS 26.502) |
|
distSessionState |
DistSessionState |
M |
1 |
The current state of the MBS Distribution Session (see clause 4.6.1 of 3GPP TS 26.502) |
|
mbUpfTunAddr |
TunnelAddress |
M |
1 |
The tunnel endpoint address of the MB‑UPF that supports this MBS Distribution Session at reference point Nmb9 or the tunnel endpoint address of the MBMS-GW at reference point SGi-mb. Write-Only: true |
|
mbmsGwTunAddr |
TunnelAddress |
O |
0..1 |
This IE may be present to contain the tunnel endpoint address of the MBMS-GW at reference point SGi-mb when the mbUpfTunAddr is also present which contains the tunnel endpoint address of the MB‑UPF that supports this MBS Distribution Session at reference point Nmb9. Write-Only: true |
|
upTrafficFlowInfo |
UpTrafficFlowInfo |
C |
0..1 |
Details of the traffic flow to be used by the MBSTF for this MBS Distribution Session, including the multicast group destination address and port number. Shall be present in case of Object Distribution Method and Packet Distribution Method in Packet Proxy Mode. Write-Only: true |
|
mbr |
BitRate |
M |
1 |
The maximum bit rate for this MBS Distribution Session Write-Only: true |
|
maxDelay |
PacketDelBudget |
O |
0..1 |
The maximum end-to-end distribution delay that is tolerated for this MBS Distribution Session by the MBS Application Provider Write-Only: true |
|
objDistributionData |
ObjDistributionData |
C |
0..1 |
Additional MBS Distribution Session parameters for Object Distribution Method (NOTE 1) |
|
pktDistributionData |
PktDistributionData |
C |
0..1 |
Additional MBS Distribution Session parameters for Packet Distribution Method (NOTE 1) |
|
fecInformation |
FECConfig |
O |
0..1 |
Configuration for FEC information added by the MBSTF to protect this MBS Distribution Session. |
|
dscpMarking |
string |
O |
0..1 |
DSCP Marking to be applied to outgoing traffic. It shall be encoded as two octet string in hexadecimal representation. The first octet shall contain the DSCP value in the IPv4 Type-of-Service or the IPv6 Traffic-Class field and the second octet shall contain the ToS/Traffic Class mask field, which shall be set to "0xFC". Write-Only: true |
|
mbsSecurityContext |
MbsSecurityContext |
O |
0..1 |
This IE may be present if security protection is applied to the MBS Session. When present, it shall contain: – the security context containing MBS Service Key (MSK), MSK lifetime and the corresponding key IDs in request from MBSF. – the security context containing MBS Service Key (MSK), MBS Traffic Key (MTK) and the corresponding key IDs in response or notification from MBSTF. |
|
NOTE 1: Either the objDistributionData IE or the pktDistributionData IE shall be present in a request/response. |
Editor’s Note: Inclusion of Security Context is FFS and depends on alignment between SA3 and SA4.
6.1.6.2.5 Type: ObjDistributionData
Table 6.1.6.2.5-1: Definition of type ObjDistributionData
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
objDistributionOperatingMode |
ObjDistributionOperatingMode |
M |
1 |
Operating Mode for the Object distribution method |
|
objAcquisitionMethod |
ObjAcquisitionMethod |
M |
1 |
Indicates whether the objects(s) are to be pushed into the MBSTF by the MBS Application Provider or whether they are to be pulled from the MBS Application Provider by the MBSTF |
|
objAcquisitionIdsPull |
array(Uri) |
C |
0..1 |
In case or PULL method, it identifies the object(s) to be ingested and distributed by the MBSTF during this MBS Distribution Session. |
|
objAcquisitionIdPush |
Uri |
C |
0..1 |
In case or PUSH method, it identifies the URL endpoint on the MBSTF used to ingest objects by the application provider. This may be present only in the response to the Create or Retrieve request Read-Only: true |
|
objIngestBaseUrl |
Uri |
C |
0..1 |
A URL prefix substituted by the MBSTF with the Object distribution base URL prior to distribution of ingested objects. Shall be present if Object Distribution base URL is present. Shall be present only in case of PUSH Method. |
|
objDistributionBaseUrl |
Uri |
O |
0..1 |
A URL prefix substituted by the MBSTF in place of the Object ingest base URL prior to distribution of ingested objects. Shall be present only in case of PUSH Method. |
|
objRepairBaseUrl |
Uri |
O |
0..1 |
A URL prefix substituted by the MBSTF in place of the Object Distribution base URL when repairing objects not received completely intact from this MBS Distribution Session. Present only when object repair is provisioned for this MBS Distribution Session. Shall be present only in case of PUSH Method. |
6.1.6.2.6 Type: PktDistributionData
Table 6.1.6.2.6-1: Definition of type PktDistributionData
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
pktDistributionOperatingMode |
PktDistributionOperatingMode |
M |
1 |
Operating Mode for the Packet distribution method |
|
pktIngestMethod |
PktIngestMethod |
C |
1 |
Indicates whether packets are ingested using multicast or unicast ingest. It shall be present if operating mode of the packet distribution method is set to "PACKET_PROXY". |
|
mbStfIngestAddr |
MbStfIngestAddr |
M |
1 |
The endpoint addresses used by the MBS Application Provider and MBSTF to establish a connection at reference point Nmb8 prior to the commencement of MBS User Data Ingest Session. |
6.1.6.2.7 Type: StatusSubscribeReqData
Table 6.1.6.2.7-1: Definition of type StatusSubscribeReqData
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
subscription |
DistSessionSubscription |
M |
1 |
Subscription to be created |
6.1.6.2.8 Type: StatusSubscribeRspData
Table 6.1.6.2.8-1: Definition of type StatusSubscribeReqData
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
subscription |
DistSessionSubscription |
M |
1 |
Subscription created |
|
reportList |
DistSessionEventReportList |
C |
0..1 |
Immediate event reports, if requested in the request and if corresponding information is available. |
6.1.6.2.9 Type: StatusNotifyReqData
Table 6.1.6.2.9-1: Definition of type StatusSubscribeReqData
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
reportList |
DistSessionEventReportList |
M |
1 |
Reported MBS session events |
6.1.6.2.10 Type: DistSessionSubscription
Table 6.1.6.2.10-1: Definition of type DistSessionSubscription
Attribute name |
Data type |
P |
Cardinality |
Description |
eventList |
array(DistSessionEventType) |
M |
1..N |
List of MBS distribution session events subscribed |
notifyUri |
Uri |
M |
1 |
URI where the NF service consumer requests to receive notifications. Write-Only: true |
notifyCorrelationId |
string |
O |
0..1 |
Notification Correlation ID Write-Only: true |
expiryTime |
DateTime |
O |
0..1 |
When present in the 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 |
distSessionSubscUri |
Uri |
C |
0..1 |
This IE shall be present in the response to an MBS distribution 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 distribution session status subscription is created separately (i.e. after) an MBS distribution session creation, the Location header returned in the MBS distribution session status subscription creation response contains the URI of the created subscription. |
6.1.6.2.11 Type: DistSessionEventReportList
Table 6.1.6.2.11-1: Definition of type DistSessionEventReportList
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
eventReportList |
array(DistSessionEventReport) |
M |
1..N |
List of MBS distribution 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. |
6.1.6.2.12 Type: DistSessionEventReport
Table 6.1.6.2.12-1: Definition of type DistSessionEventReport
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
eventType |
DistSessionEventType |
M |
1 |
MBS distribution 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. |
|
mbsSecurityContext |
MbsSecurityContext |
C |
0..1 |
This IE shall be present if the eventType IE indicates "MTK_UPDATE" or "MSK_REQUEST". |
Editor’s Note: Inclusion of Security Context is FFS and depends on alignment between SA3 and SA4.
6.1.6.2.13 Type: UpTrafficFlowInfo
Table 6.1.6.2.13-1: Definition of type UpTrafficFlowInfo
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
destIpAddr |
IpAddr |
M |
1 |
Multicast group destination Address |
|
portNumber |
Uinteger |
M |
1 |
Port Number |
6.1.6.2.14 Type: MbStfIngestAddr
Table 6.1.6.2.14-1: Definition of type MbStfIngestAddr
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
afEgressTunAddr |
TunnelAddress |
C |
0..1 |
AF side endpoint address and port for establishment of unicast tunnel at reference point Nmb8 prior to the commencement of MBS User Data Ingest Session. The MBSTF shall use this information to validate the source IP address and port of incoming packets pertaining to the MBS User Data Ingest Session from the MBS Application Provider. This IE shall be included if the packet distribution method is used and when the operating mode is set to "PACKET_FORWARD_ONLY", or when the operating mode is set to "PACKET_PROXY" while the packet ingest method is set to unicast. This shall be present only in the Create request. Write-Only: true |
|
mbStfIngressTunAddr |
TunnelAddress |
C |
0..1 |
MBSTF side endpoint address and port for establishment of unicast tunnel at reference point Nmb8 prior to the commencement of MBS User Data Ingest Session. It is applicable only if operating mode of the packet distribution method is set to "PACKET_FORWARD_ONLY". This shall be present only in the response to the Create (or Retrieve) request. Read-Only: true |
|
afSsm |
ExtSsm |
C |
0..1 |
AF side Source specific multicast address and port to which MBSTF issues an IGMP Join to ingest multicast UDP/IP datagrams. It is applicable only if operating mode of the packet distribution method is set to "PACKET_PROXY" and packet ingest method is set to "MULTICAST". This shall be present only in the Create request. Write-Only: true |
|
mbStfListenAddr |
TunnelAddress |
C |
0..1 |
MBSTF side endpoint address and port for to receive unicast-addressed UDP/IP datagrams. It is applicable only if operating mode of the packet distribution method is set to "PACKET_PROXY" and packet ingest method is set to "UNICAST". This shall be present only in the response to the Create (or Retrieve) request. Read-Only: true |
6.1.6.2.15 Type: ExtSsm
Table 6.1.6.2.15-1: Definition of type ExtSsm
Attribute name |
Data type |
P |
Cardinality |
Description |
Applicability |
ssm |
Ssm |
M |
1 |
Source Specific Multicast Address consisting of multicast source IP address and the destination multicast address |
|
portNumber |
Uinteger |
M |
1 |
Source Port |
6.1.6.3 Simple data types and enumerations
6.1.6.3.1 Introduction
This clause defines simple data types and enumerations that can be referenced from data structures defined in the previous clauses.
6.1.6.3.2 Simple data types
None
6.1.6.3.3 Enumeration: DistSessionState
The enumeration DistSessionState represents the current state of the MBS Distribution Session. It shall comply with the values defined in table 6.1.6.3.3-1.
Table 6.1.6.3.3-1: Enumeration DistSessionState
Enumeration value |
Description |
Applicability |
"INACTIVE" |
Distribution Session in Inactive |
|
"ESTABLISHED" |
Distribution Session in Established |
|
"ACTIVE" |
Distribution Session in Active |
|
"DEACTIVATING" |
Distribution Session in Released |
6.1.6.3.4 Enumeration: ObjDistributionOperatingMode
The enumeration ObjDistributionOperatingMode defines the mode of data ingestion for Object distribution method. It shall comply with the values defined in table 6.1.6.3.4-1.
Table 6.1.6.3.4-1: Enumeration ObjDistributionOperatingMode
Enumeration value |
Description |
Applicability |
"SINGLE" |
Each object ingested by the MBSTF is distributed once |
|
"COLLECTION" |
A set of objects described by a manifest is ingested by the MBSTF and distributed once Not used with Push-based ingest |
|
"CAROUSEL" |
A set of one or more objects described by a manifest is ingested by the MBSTF and distributed according to a repetition pattern specified in the manifest Not used with Push-based ingest |
|
"STREAMING" |
A sequence of objects is ingested by the MBSTF and streamed in real time |
6.1.6.3.5 Enumeration: ObjAcquisitionMethod
The enumeration ObjAcquisitionMethod indicates whether the objects(s) are to be pushed into the MBSTF by the MBS Application Provider or whether they are to be pulled from the MBS Application Provider by the MBSTF. It shall comply with the values defined in table 6.1.6.3.5-1.
Table 6.1.6.3.5-1: Enumeration ObjAcquisitionMethod
Enumeration value |
Description |
Applicability |
"PULL" |
MBSTF Pulls objects from AF/AS |
|
"PUSH" |
AF/AS Pushes objects into MBSTF |
6.1.6.3.6 Enumeration: PktDistributionOperatingMode
The enumeration PktDistributionOperatingMode defines the mode of data ingestion for Packet distribution method. It shall comply with the values defined in table 6.1.6.3.6-1.
Table 6.1.6.3.6-1: Enumeration PktDistributionOperatingMode
Enumeration value |
Description |
Applicability |
"PACKET_PROXY" |
The payloads of UDP packets ingested by the MBSTF are forwarded to the MB-UPF in new UDP packets (Layer 4 proxying) |
|
"PACKET_FORWARD_ONLY" |
The payloads of IP packets ingested by the MBSTF are forwarded to the MB-UPF in new IP packets (Layer 3 proxying) |
6.1.6.3.7 Enumeration: DistSessionEventType
The enumeration DistSessionEventType defines the status of the MBS distribution session that NF consumer wants to subscribe to. It shall comply with the values defined in table 6.1.6.3.7-1.
Table 6.1.6.3.7-1: Enumeration DistSessionEventType
Enumeration value |
Description |
Applicability |
"DATA_INGEST_FAILURE" |
MBSTF failed to ingest data from AF/AS |
|
"SESSION_DEACTIVATED" |
Session released in MBSTF |
|
"SESSION_ACTIVATED" |
Delivery started towards MB-UPF |
Editor’s Note: Inclusion of Security Context Events is FFS and depends on alignment between SA3 and SA4.
6.1.6.3.8 Enumeration: PktIngestMethod
The enumeration PktIngestMethod defines the mode of data ingestion for Packet distribution method. It shall comply with the values defined in table 6.1.6.3.8-1.
Table 6.1.6.3.8-1: Enumeration PktIngestMethod
Enumeration value |
Description |
Applicability |
"MULTICAST" |
Multicast Ingest Mode |
|
"UNICAST" |
Unicast Ingest Mode |
6.1.6.4 Data types describing alternative data types or combinations of data types
None
6.1.6.5 Binary data
None
6.1.7 Error Handling
6.1.7.1 General
For the Nmbstf-distsession API, 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 Nmbstf-distsession API.
6.1.7.2 Protocol Errors
No specific procedures for the Nmbstf-distsession service are specified.
6.1.7.3 Application Errors
The application errors defined for the Nmbstf-distsession service are listed in Table 6.1.7.3-1.
Table 6.1.7.3-1: Application errors
Application Error |
HTTP status code |
Description |
6.1.8 Feature negotiation
The optional features in table 6.1.8-1 are defined for the Nmbstf-distsession API. They shall be negotiated using the extensibility mechanism defined in clause 6.6 of 3GPP TS 29.500 [4].
Table 6.1.8-1: Supported Features
Feature number |
Feature Name |
Description |
6.1.9 Security
As indicated in 3GPP TS 33.501 [8] and 3GPP TS 29.500 [4], the access to the Nmbstf-distsession API may be authorized by means of the OAuth2 protocol (see IETF RFC 6749 [9]), based on local configuration, using the "Client Credentials" authorization grant, where the NRF (see 3GPP TS 29.510 [10]) plays the role of the authorization server.
If OAuth2 is used, an NF Service Consumer, prior to consuming services offered by the Nmbstf-distsession API, shall obtain a "token" from the authorization server, by invoking the Access Token Request service, as described in 3GPP TS 29.510 [10], clause 5.4.2.2.
NOTE: When multiple NRFs are deployed in a network, the NRF used as authorization server is the same NRF that the NF Service Consumer used for discovering the Nmbstf-distsession service.
The Nmbstf-distsession API defines a single scope "nmbstf-distsession " for the entire service, and it does not define any additional scopes at resource or operation level.
Annex A (normative):
OpenAPI specification