schemes:
- http
paths:
- /subscriptions:
+ /config:
get:
- summary: Returns list of subscriptions
+ summary: Returns the configuration of all xapps
tags:
- - "query"
- operationId: getAllSubscriptions
+ - xapp
+ operationId: getXappConfigList
produces:
- application/json
+ - application/xml
responses:
'200':
- description: successful query of subscriptions
+ description: successful query of xApp config
schema:
- $ref: '#/definitions/SubscriptionList'
+ $ref: '#/definitions/XappConfigList'
'500':
description: Internal error
- /subscriptions/report:
- post:
+ /subscriptions:
+ get:
+ summary: Returns list of subscriptions
tags:
- - "report"
- summary: Subscribe a list of X2AP event triggers to receive "REPORT" messages sent by RAN or Subscribe to receive the content of gNB NRT table in REPORT message sent by RAN
- operationId: subscribeReport
- consumes:
- - application/json
+ - "common"
+ operationId: getAllSubscriptions
produces:
- application/json
- parameters:
- - name: ReportParams
- in: body
- description: Subscription report parameters
- schema:
- $ref: '#/definitions/ReportParams'
responses:
- '201':
- description: Subscription successfully created
+ '200':
+ description: successful query of subscriptions
schema:
- $ref: '#/definitions/SubscriptionResponse'
- '400':
- description: Invalid input
+ $ref: '#/definitions/SubscriptionList'
'500':
description: Internal error
- /subscriptions/policy:
post:
tags:
- - "policy"
- summary: Subscribe and send "POLICY" message to RAN to execute a specific POLICY during call processing in RAN after each occurrence of a defined SUBSCRIPTION
- operationId: subscribePolicy
+ - "common"
+ operationId: Subscribe
+ summary: Subscribe a list of X2AP event triggers to receive messages sent by RAN
consumes:
- application/json
produces:
- application/json
parameters:
- - name: PolicyParams
+ - name: SubscriptionParams
in: body
- description: Subscription policy parameters
+ description: Subscription parameters
schema:
- $ref: '#/definitions/PolicyParams'
+ $ref: '#/definitions/SubscriptionParams'
responses:
'201':
description: Subscription successfully created
description: Invalid input
'500':
description: Internal error
- /subscriptions/{subscriptionId}:
+ '/subscriptions/{subscriptionId}':
delete:
tags:
- - "common"
+ - "common"
summary: Unsubscribe X2AP events from Subscription Manager
operationId: Unsubscribe
+ consumes:
+ - application/json
+ produces:
+ - application/json
parameters:
- name: subscriptionId
in: path
'500':
description: Internal error
definitions:
- SubscriptionType:
- type: string
- enum:
- - insert
- - policy
- - report
- ReportParams:
+ ConfigMetadata:
type: object
required:
- - RANFunctionID
- - ClientEndpoint
- - EventTriggers
+ - xappName
+ - configType
properties:
- Meid:
+ xappName:
type: string
- RANFunctionID:
- type: integer
- ClientEndpoint:
+ description: Name of the xApp
+ configType:
type: string
- EventTriggers:
- $ref: '#/definitions/EventTriggerList'
- ReportActionDefinitions:
- $ref: '#/definitions/ReportActionDefinition'
- EventTrigger:
+ description: The type of the content
+ enum:
+ - json
+ - xml
+ - other
+ XAppConfig:
type: object
+ required:
+ - metadata
+ - config
properties:
- InterfaceDirection:
- type: integer
- ProcedureCode:
- type: integer
- TypeOfMessage:
- type: integer
- TriggerNature:
- type: string
- enum:
- - now
- - on change
- PlmnId:
- type: string
- ENBId:
- type: string
- EventTriggerList:
+ metadata:
+ $ref: '#/definitions/ConfigMetadata'
+ config:
+ type: object
+ description: Configuration in JSON format
+ XappConfigList:
type: array
items:
- $ref: '#/definitions/EventTrigger'
- ActionParameters:
+ $ref: '#/definitions/XAppConfig'
+
+ ActionDefinition:
type: object
- required:
- - ActionParameterID
- - ActionParameterValue
+ description: E2SM Octet string. ActionDefinition is an OPTIONAL IE
properties:
- ActionParameterID:
- type: integer
- ActionParameterValue:
- type: boolean
- Format1ActionDefinition:
+ OctetString:
+ type: string
+ SubsequentAction:
+ description: SubsequentAction is an OPTIONAL IE
type: object
required:
- - StyleID
- - ActionParameters
+ - SubsequentActionType
+ - TimeToWait
properties:
- StyleID:
- type: integer
- ActionParameters:
- type: array
- items:
- $ref: '#/definitions/ActionParameters'
- ReportActionDefinition:
- type: object
- properties:
- ActionDefinitionFormat1:
- $ref: '#/definitions/Format1ActionDefinition'
- PolicyParams:
+ SubsequentActionType:
+ type: string
+ enum:
+ - continue
+ - wait
+ TimeToWait:
+ type: string
+ enum:
+ - zero
+ - w1ms
+ - w2ms
+ - w5ms
+ - w10ms
+ - w20ms
+ - w30ms
+ - w40ms
+ - w50ms
+ - w100ms
+ - w200ms
+ - w500ms
+ - w1s
+ - w2s
+ - w5s
+ - w10s
+ - w20s
+ - w60s
+ ActionToBeSetup:
type: object
required:
- - Meid
- - RANFunctionID
- - ClientEndpoint
- - EventTriggers
- - PolicyActionDefinitions
+ - ActionID
+ - ActionType
properties:
- Meid:
- type: string
- RANFunctionID:
+ ActionID:
type: integer
- ClientEndpoint:
+ minimum: 0
+ maximum: 255
+ ActionType:
type: string
- EventTriggers:
- $ref: '#/definitions/EventTriggerList'
- PolicyActionDefinitions:
- $ref: '#/definitions/PolicyActionDefinition'
- PolicyActionDefinition:
- type: object
- properties:
- ActionDefinitionFormat2:
- $ref: '#/definitions/Format2ActionDefinition'
- Format2ActionDefinition:
+ enum:
+ - insert
+ - policy
+ - report
+ ActionDefinition:
+ $ref: '#/definitions/ActionDefinition'
+ SubsequentAction:
+ $ref: '#/definitions/SubsequentAction'
+ ActionsToBeSetup:
+ type: array
+ items:
+ $ref: '#/definitions/ActionToBeSetup'
+ EventTriggerDefinition:
type: object
- required:
- - RANUeGroupParameters
+ description: E2SM Octet string
properties:
- RANUeGroupParameters:
- type: array
- items:
- $ref: '#/definitions/RANUeGroupList'
- RANUeGroupList:
+ OctetString:
+ type: string
+ SubscriptionDetail:
type: object
required:
- - RANUeGroupID
- - RANUeGroupDefinition
- - RANImperativePolicy
+ - RequestorId
+ - InstanceId
+ - EventTriggers
+ - ActionToBeSetupList
properties:
- RANUeGroupID:
+ RequestorId:
+ type: integer
+ minimum: 0
+ maximum: 65535
+ InstanceId:
type: integer
- RANUeGroupDefinition:
- $ref: '#/definitions/RANUeGroupParams'
- RANImperativePolicy:
- $ref: '#/definitions/ImperativePolicyDefinition'
- RANUeGroupParams:
+ minimum: 0
+ maximum: 65535
+ EventTriggers:
+ $ref: '#/definitions/EventTriggerDefinition'
+ ActionToBeSetupList:
+ $ref: '#/definitions/ActionsToBeSetup'
+ SubscriptionDetailsList:
+ type: array
+ items:
+ $ref: '#/definitions/SubscriptionDetail'
+ SubscriptionParams:
type: object
required:
- - RANParameterID
- - RANParameterValue
+ - ClientEndpoint
+ - Meid
+ - RANFunctionID
+ - SubscriptionDetails
properties:
- RANParameterID:
- type: integer
- RANParameterTestCondition:
+ ClientEndpoint:
+ type: object
+ description: xApp service address and port
+ properties:
+ Host:
+ description: >-
+ xApp service address name like 'service-ricxapp-xappname-http.ricxapp'
+ type: string
+ HTTPPort:
+ description: xApp HTTP service address port
+ type: integer
+ minimum: 0
+ maximum: 65535
+ RMRPort:
+ description: xApp RMR service address port
+ type: integer
+ minimum: 0
+ maximum: 65535
+ Meid:
type: string
- enum:
- - equal
- - greaterthan
- - lessthan
- - contains
- - present
- RANParameterValue:
+ RANFunctionID:
type: integer
- ImperativePolicyDefinition:
+ minimum: 0
+ maximum: 4095
+ SubscriptionDetails:
+ $ref: '#/definitions/SubscriptionDetailsList'
+ SubscriptionResponse:
type: object
required:
- - PolicyParameterID
- - PolicyParameterValue
+ - SubscriptionId
+ - SubscriptionInstances
properties:
- PolicyParameterID:
- type: integer
- PolicyParameterValue:
- type: integer
- SubscriptionResponseItem:
+ SubscriptionId:
+ type: string
+ SubscriptionInstances:
+ type: array
+ items:
+ $ref: '#/definitions/SubscriptionInstance'
+ SubscriptionInstance:
type: object
required:
- - SubscriptionId
- RequestorId
- InstanceId
+ - ErrorCause
properties:
- SubscriptionId:
- type: string
RequestorId:
type: integer
+ minimum: 0
+ maximum: 65535
InstanceId:
type: integer
- SubscriptionResponse:
- type: array
- items:
- $ref: '#/definitions/SubscriptionResponseItem'
+ minimum: 0
+ maximum: 65535
+ ErrorCause:
+ description: Empty string when no error.
+ type: string
SubscriptionData:
type: object
properties:
type: integer
Meid:
type: string
- Endpoint:
+ ClientEndpoint:
type: array
items:
type: string
+ SubscriptionInstances:
+ type: array
+ items:
+ $ref: '#/definitions/SubscriptionInstance'
SubscriptionList:
type: array
description: A list of subscriptions