open5gs/lib/sbi/support/r17-20230301-openapitools-6.4.0/modified/TS29518_Namf_MBSBroadcast.yaml
2023-03-01 17:50:25 +09:00

768 lines
27 KiB
YAML

openapi: 3.0.0
info:
version: 1.0.2
title: Namf_MBSBroadcast
description: |
AMF MBSBroadcast Service.
© 2022, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
All rights reserved.
externalDocs:
description: 3GPP TS 29.518 V17.8.0; 5G System; Access and Mobility Management Services
url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/29.518/'
servers:
- url: '{apiRoot}/namf-mbs-bc/v1'
variables:
apiRoot:
default: https://example.com
description: apiRoot as defined in clause 4.4 of 3GPP TS 29.501
security:
- {}
- oAuth2ClientCredentials:
- namf-mbs-bc
paths:
/mbs-contexts:
post:
summary: Namf_MBSBroadcast ContextCreate service Operation
tags:
- Broadcast MBS session contexts collection (Collection)
operationId: ContextCreate
requestBody:
content:
multipart/related: # message with binary body part(s)
schema:
type: object
properties: # Request parts
jsonData:
$ref: '#/components/schemas/ContextCreateReqData'
binaryDataN2Information:
type: string
format: binary
encoding:
jsonData:
contentType: application/json
binaryDataN2Information:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
required: true
callbacks:
contextStatusNotification:
'{$request.body#/notifyUri}':
post:
requestBody: # notification request without binary body part
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ContextStatusNotification'
multipart/related: # notification request with binary body part(s)
schema:
type: object
properties: # Request parts
jsonData:
$ref: '#/components/schemas/ContextStatusNotification'
binaryDataN2Information1:
type: string
format: binary
binaryDataN2Information2:
type: string
format: binary
binaryDataN2Information3:
type: string
format: binary
binaryDataN2Information4:
type: string
format: binary
binaryDataN2Information5:
type: string
format: binary
binaryDataN2Information6:
type: string
format: binary
binaryDataN2Information7:
type: string
format: binary
binaryDataN2Information8:
type: string
format: binary
binaryDataN2Information9:
type: string
format: binary
binaryDataN2Information10:
type: string
format: binary
encoding:
jsonData:
contentType: application/json
binaryDataN2Information1:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information2:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information3:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information4:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information5:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information6:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information7:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information8:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information9:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information10:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
responses:
'204':
description: successful notification
'307':
$ref: 'TS29571_CommonData.yaml#/components/responses/307'
'308':
$ref: 'TS29571_CommonData.yaml#/components/responses/308'
'400':
$ref: 'TS29571_CommonData.yaml#/components/responses/400'
'403':
$ref: 'TS29571_CommonData.yaml#/components/responses/403'
'404':
$ref: 'TS29571_CommonData.yaml#/components/responses/404'
'411':
$ref: 'TS29571_CommonData.yaml#/components/responses/411'
'413':
$ref: 'TS29571_CommonData.yaml#/components/responses/413'
'415':
$ref: 'TS29571_CommonData.yaml#/components/responses/415'
'429':
$ref: 'TS29571_CommonData.yaml#/components/responses/429'
'500':
$ref: 'TS29571_CommonData.yaml#/components/responses/500'
'503':
$ref: 'TS29571_CommonData.yaml#/components/responses/503'
responses:
'201':
description: MBS Broadcast context created successfully
headers:
Location:
description: 'Contains the URI of the newly created resource, according to the structure: {apiRoot}/namf-mbs-bc/<apiVersion>/mbs-contexts/{mbsContextRef}'
required: true
schema:
type: string
content:
application/json: # message without binary body part(s)
schema:
$ref: '#/components/schemas/ContextCreateRspData'
multipart/related: # message with binary body part(s)
schema:
type: object
properties: # Response parts
jsonData:
$ref: '#/components/schemas/ContextCreateRspData'
binaryDataN2Information1:
type: string
format: binary
binaryDataN2Information2:
type: string
format: binary
binaryDataN2Information3:
type: string
format: binary
binaryDataN2Information4:
type: string
format: binary
binaryDataN2Information5:
type: string
format: binary
binaryDataN2Information6:
type: string
format: binary
binaryDataN2Information7:
type: string
format: binary
binaryDataN2Information8:
type: string
format: binary
binaryDataN2Information9:
type: string
format: binary
binaryDataN2Information10:
type: string
format: binary
encoding:
jsonData:
contentType: application/json
binaryDataN2Information1:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information2:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information3:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information4:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information5:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information6:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information7:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information8:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information9:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information10:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
'307':
$ref: 'TS29571_CommonData.yaml#/components/responses/307'
'308':
$ref: 'TS29571_CommonData.yaml#/components/responses/308'
'400':
$ref: 'TS29571_CommonData.yaml#/components/responses/400'
'401':
$ref: 'TS29571_CommonData.yaml#/components/responses/401'
'403':
$ref: 'TS29571_CommonData.yaml#/components/responses/403'
'404':
$ref: 'TS29571_CommonData.yaml#/components/responses/404'
'411':
$ref: 'TS29571_CommonData.yaml#/components/responses/411'
'413':
$ref: 'TS29571_CommonData.yaml#/components/responses/413'
'415':
$ref: 'TS29571_CommonData.yaml#/components/responses/415'
'429':
$ref: 'TS29571_CommonData.yaml#/components/responses/429'
'500':
$ref: 'TS29571_CommonData.yaml#/components/responses/500'
'502':
$ref: 'TS29571_CommonData.yaml#/components/responses/502'
'503':
$ref: 'TS29571_CommonData.yaml#/components/responses/503'
default:
$ref: 'TS29571_CommonData.yaml#/components/responses/default'
/mbs-contexts/{mbsContextRef}:
delete:
summary: Namf_MBSBroadcast ContextDelete service Operation
tags:
- Individual broadcast MBS session context (Document)
operationId: ContextDelete
parameters:
- name: mbsContextRef
in: path
required: true
description: Unique ID of the broadcast MSB session context to be deleted
schema:
type: string
responses:
'204':
description: successful deletion
'307':
$ref: 'TS29571_CommonData.yaml#/components/responses/307'
'308':
$ref: 'TS29571_CommonData.yaml#/components/responses/308'
'400':
$ref: 'TS29571_CommonData.yaml#/components/responses/400'
'401':
$ref: 'TS29571_CommonData.yaml#/components/responses/401'
'403':
$ref: 'TS29571_CommonData.yaml#/components/responses/403'
'404':
$ref: 'TS29571_CommonData.yaml#/components/responses/404'
'429':
$ref: 'TS29571_CommonData.yaml#/components/responses/429'
'500':
$ref: 'TS29571_CommonData.yaml#/components/responses/500'
'502':
$ref: 'TS29571_CommonData.yaml#/components/responses/502'
'503':
$ref: 'TS29571_CommonData.yaml#/components/responses/503'
default:
$ref: 'TS29571_CommonData.yaml#/components/responses/default'
/mbs-contexts/{mbsContextRef}/update:
post:
summary: Namf_MBSBroadcast ContextUpdate service Operation
tags:
- Individual broadcast MBS session context (Document)
operationId: ContextUpdate
parameters:
- name: mbsContextRef
in: path
description: Unique ID of the broadcast MSB session context to be updated
required: true
schema:
type: string
requestBody:
content:
multipart/related: # message with binary body part(s)
schema:
type: object
properties: # Request parts
jsonData:
$ref: '#/components/schemas/ContextUpdateReqData'
binaryDataN2Information:
type: string
format: binary
encoding:
jsonData:
contentType: application/json
binaryDataN2Information:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
required: true
responses:
'200':
description: MBS Broadcast context updated successfully
content:
application/json: # message without binary body part(s)
schema:
$ref: '#/components/schemas/ContextUpdateRspData'
multipart/related: # message with binary body part(s)
schema:
type: object
properties: # Response parts
jsonData:
$ref: '#/components/schemas/ContextUpdateRspData'
binaryDataN2Information1:
type: string
format: binary
binaryDataN2Information2:
type: string
format: binary
binaryDataN2Information3:
type: string
format: binary
binaryDataN2Information4:
type: string
format: binary
binaryDataN2Information5:
type: string
format: binary
binaryDataN2Information6:
type: string
format: binary
binaryDataN2Information7:
type: string
format: binary
binaryDataN2Information8:
type: string
format: binary
binaryDataN2Information9:
type: string
format: binary
binaryDataN2Information10:
type: string
format: binary
encoding:
jsonData:
contentType: application/json
binaryDataN2Information1:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information2:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information3:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information4:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information5:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information6:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information7:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information8:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information9:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
binaryDataN2Information10:
contentType: application/vnd.3gpp.ngap
headers:
Content-Id:
schema:
type: string
'204':
description: MBS Broadcast context updated successfully. No Content.
'307':
$ref: 'TS29571_CommonData.yaml#/components/responses/307'
'308':
$ref: 'TS29571_CommonData.yaml#/components/responses/308'
'400':
$ref: 'TS29571_CommonData.yaml#/components/responses/400'
'401':
$ref: 'TS29571_CommonData.yaml#/components/responses/401'
'403':
$ref: 'TS29571_CommonData.yaml#/components/responses/403'
'404':
$ref: 'TS29571_CommonData.yaml#/components/responses/404'
'411':
$ref: 'TS29571_CommonData.yaml#/components/responses/411'
'413':
$ref: 'TS29571_CommonData.yaml#/components/responses/413'
'415':
$ref: 'TS29571_CommonData.yaml#/components/responses/415'
'429':
$ref: 'TS29571_CommonData.yaml#/components/responses/429'
'500':
$ref: 'TS29571_CommonData.yaml#/components/responses/500'
'502':
$ref: 'TS29571_CommonData.yaml#/components/responses/502'
'503':
$ref: 'TS29571_CommonData.yaml#/components/responses/503'
default:
$ref: 'TS29571_CommonData.yaml#/components/responses/default'
components:
securitySchemes:
oAuth2ClientCredentials:
type: oauth2
flows:
clientCredentials:
tokenUrl: '{nrfApiRoot}/oauth2/token'
scopes:
namf-mbs-bc: Access to the Namf_MBSBroadcast API
schemas:
#
# STRUCTURED DATA TYPES
#
ContextCreateReqData:
description: Data within ContextCreate Request
type: object
properties:
mbsSessionId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/MbsSessionId'
mbsServiceAreaInfoList:
type: array
items:
$ref: 'TS29571_CommonData.yaml#/components/schemas/MbsServiceAreaInfo'
minItems: 1
mbsServiceArea:
$ref: 'TS29571_CommonData.yaml#/components/schemas/MbsServiceArea'
n2MbsSmInfo:
$ref: '#/components/schemas/N2MbsSmInfo'
notifyUri:
$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
maxResponseTime:
$ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec'
snssai:
$ref: 'TS29571_CommonData.yaml#/components/schemas/Snssai'
mbsmfId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId'
mbsmfServiceInstId:
type: string
required:
- mbsSessionId
- n2MbsSmInfo
- notifyUri
- snssai
oneOf:
- required: [ mbsServiceArea ]
- required: [ mbsServiceAreaInfoList ]
ContextCreateRspData:
description: Data within ContextCreate Response
type: object
properties:
mbsSessionId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/MbsSessionId'
n2MbsSmInfoList:
type: array
items:
$ref: '#/components/schemas/N2MbsSmInfo'
minItems: 1
maxItems: 10
operationStatus:
$ref: '#/components/schemas/OperationStatus'
required:
- mbsSessionId
ContextUpdateReqData:
description: Data within ContextUpdate Request
type: object
properties:
mbsServiceArea:
$ref: 'TS29571_CommonData.yaml#/components/schemas/MbsServiceArea'
mbsServiceAreaInfoList:
type: array
items:
$ref: 'TS29571_CommonData.yaml#/components/schemas/MbsServiceAreaInfo'
minItems: 1
n2MbsSmInfo:
$ref: '#/components/schemas/N2MbsSmInfo'
ranIdList:
type: array
items:
$ref: 'TS29571_CommonData.yaml#/components/schemas/GlobalRanNodeId'
minItems: 1
noNgapSignallingInd:
type: boolean
enum:
- true
notifyUri:
$ref: 'TS29571_CommonData.yaml#/components/schemas/Uri'
maxResponseTime:
$ref: 'TS29571_CommonData.yaml#/components/schemas/DurationSec'
n2MbsInfoChangeInd:
type: boolean
not:
required: [ mbsServiceArea, mbsServiceAreaInfoList ]
ContextStatusNotification:
description: Data within ContextStatusNotify Request
type: object
properties:
mbsSessionId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/MbsSessionId'
areaSessionId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/AreaSessionId'
n2MbsSmInfoList:
type: array
items:
$ref: '#/components/schemas/N2MbsSmInfo'
minItems: 1
maxItems: 10
operationEvents:
type: array
items:
$ref: '#/components/schemas/OperationEvent'
minItems: 1
operationStatus:
$ref: '#/components/schemas/OperationStatus'
required:
- mbsSessionId
ContextUpdateRspData:
description: Data within ContextUpdate Response
type: object
properties:
n2MbsSmInfoList:
type: array
items:
$ref: '#/components/schemas/N2MbsSmInfo'
minItems: 1
maxItems: 10
operationStatus:
$ref: '#/components/schemas/OperationStatus'
N2MbsSmInfo:
description: N2 MBS Session Management information
type: object
properties:
ngapIeType:
$ref: '#/components/schemas/NgapIeType'
ngapData:
$ref: 'TS29571_CommonData.yaml#/components/schemas/RefToBinaryData'
randId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/GlobalRanNodeId'
required:
- ngapIeType
- ngapData
- randId
OperationEvent:
description: Operation Event for a Broadcast MBS Session.
type: object
properties:
opEventType:
$ref: '#/components/schemas/OpEventType'
amfId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/NfInstanceId'
ngranFailureEventList:
type: array
items:
$ref: '#/components/schemas/NgranFailureEvent'
minItems: 1
required:
- opEventType
NgranFailureEvent:
description: NG-RAN failure event for a NG-RAN
type: object
properties:
ngranId:
$ref: 'TS29571_CommonData.yaml#/components/schemas/GlobalRanNodeId'
ngranFailureIndication:
$ref: '#/components/schemas/NgranFailureIndication'
required:
- ngranId
- ngranFailureIndication
#
# SIMPLE DATA TYPES
#
#
# ENUMERATIONS
#
OperationStatus:
description: Status of a Broadcast MBS session start or update operation.
anyOf:
- type: string
enum:
- MBS_SESSION_START_COMPLETE
- MBS_SESSION_START_INCOMPLETE
- MBS_SESSION_UPDATE_COMPLETE
- MBS_SESSION_UPDATE_INCOMPLETE
- type: string
NgapIeType:
description: NGAP Information Element Type
anyOf:
- type: string
enum:
- MBS_SES_REQ
- MBS_SES_RSP
- MBS_SES_FAIL
- MBS_SES_REL_RSP
- type: string
OpEventType:
description: Operation Event Type.
anyOf:
- type: string
enum:
- AMF_CHANGE
- NG_RAN_EVENT
- type: string
NgranFailureIndication:
description: Indicates a NG-RAN failure event.
anyOf:
- type: string
enum:
- NG_RAN_RESTART_OR_START
- NG_RAN_FAILURE_WITHOUT_RESTART
- NG_RAN_NOT_REACHABLE
- type: string