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