X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=api%2Fxapp_rest_api.yaml;h=efd5b8c161dfe2148ba5188cb0addbf2246cc7c2;hb=5bd7273045e37ac20a0d79c03e9e9a24415b2b67;hp=f5a6f57c5d75cb8d08191d03943081cc605e9cdf;hpb=9568a2d73b96516b27f54650e309f0d157fb97d9;p=ric-plt%2Fxapp-frame.git diff --git a/api/xapp_rest_api.yaml b/api/xapp_rest_api.yaml index f5a6f57..efd5b8c 100755 --- a/api/xapp_rest_api.yaml +++ b/api/xapp_rest_api.yaml @@ -1,4 +1,4 @@ -swagger: '2.0' +swagger: "2.0" info: description: This is the initial REST API for RIC subscription version: 0.0.1 @@ -30,7 +30,7 @@ paths: post: tags: - "report" - summary: Subscribe a list of X2AP event triggers to receive "REPORT" messages sent by RAN + 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 @@ -46,32 +46,7 @@ paths: '201': description: Subscription successfully created schema: - $ref: '#/definitions/SubscriptionResult' - '400': - description: Invalid input - '500': - description: Internal error - /subscriptions/control: - post: - tags: - - "control" - summary: Subscribe and send "CONTROL" message to RAN to initiate or resume call processing in RAN - operationId: subscribeControl - consumes: - - application/json - produces: - - application/json - parameters: - - name: ControlParams - in: body - description: Subscription control parameters - schema: - $ref: '#/definitions/ControlParams' - responses: - '201': - description: Subscription successfully created - schema: - $ref: '#/definitions/SubscriptionResult' + $ref: '#/definitions/SubscriptionResponse' '400': description: Invalid input '500': @@ -96,7 +71,7 @@ paths: '201': description: Subscription successfully created schema: - $ref: '#/definitions/SubscriptionResult' + $ref: '#/definitions/SubscriptionResponse' '400': description: Invalid input '500': @@ -107,43 +82,49 @@ paths: - "common" summary: Unsubscribe X2AP events from Subscription Manager operationId: Unsubscribe + consumes: + - application/json + produces: + - application/json parameters: - name: subscriptionId in: path - description: The subscriptionId to be unsubscribed + description: The subscriptionId received in the Subscription Response required: true - type: integer + type: string responses: '204': description: Operation done successfully '400': - description: Invalid requestorId supplied + description: Invalid subscriptionId supplied '500': description: Internal error definitions: SubscriptionType: type: string enum: - - control - insert - policy - report ReportParams: type: object required: - - RequestorId + - RANFunctionID + - ClientEndpoint - EventTriggers properties: - RequestorId: + Meid: + type: string + RANFunctionID: type: integer + ClientEndpoint: + type: string EventTriggers: $ref: '#/definitions/EventTriggerList' + ReportActionDefinitions: + $ref: '#/definitions/ReportActionDefinition' EventTrigger: type: object - required: - - InterfaceDirection - - ProcedureCode - - TypeOfMessage properties: InterfaceDirection: type: integer @@ -151,33 +132,142 @@ definitions: type: integer TypeOfMessage: type: integer + TriggerNature: + type: string + enum: + - now + - on change PlmnId: type: string ENBId: - type: integer + type: string EventTriggerList: type: array items: $ref: '#/definitions/EventTrigger' - SubscriptionResult: - type: array - description: A list of unique IDs - items: - type: integer - ControlParams: + ActionParameters: type: object + required: + - ActionParameterID + - ActionParameterValue properties: - RequestorId: + ActionParameterID: type: integer - TBD: - type: string + ActionParameterValue: + type: boolean + Format1ActionDefinition: + type: object + required: + - StyleID + - ActionParameters + properties: + StyleID: + type: integer + ActionParameters: + type: array + items: + $ref: '#/definitions/ActionParameters' + ReportActionDefinition: + type: object + properties: + ActionDefinitionFormat1: + $ref: '#/definitions/Format1ActionDefinition' PolicyParams: type: object + required: + - Meid + - RANFunctionID + - ClientEndpoint + - EventTriggers + - PolicyActionDefinitions + properties: + Meid: + type: string + RANFunctionID: + type: integer + ClientEndpoint: + type: string + EventTriggers: + $ref: '#/definitions/EventTriggerList' + PolicyActionDefinitions: + $ref: '#/definitions/PolicyActionDefinition' + PolicyActionDefinition: + type: object + properties: + ActionDefinitionFormat2: + $ref: '#/definitions/Format2ActionDefinition' + Format2ActionDefinition: + type: object + required: + - RANUeGroupParameters + properties: + RANUeGroupParameters: + type: array + items: + $ref: '#/definitions/RANUeGroupList' + RANUeGroupList: + type: object + required: + - RANUeGroupID + - RANUeGroupDefinition + - RANImperativePolicy + properties: + RANUeGroupID: + type: integer + RANUeGroupDefinition: + $ref: '#/definitions/RANUeGroupParams' + RANImperativePolicy: + $ref: '#/definitions/ImperativePolicyDefinition' + RANUeGroupParams: + type: object + required: + - RANParameterID + - RANParameterValue + properties: + RANParameterID: + type: integer + RANParameterTestCondition: + type: string + enum: + - equal + - greaterthan + - lessthan + - contains + - present + RANParameterValue: + type: integer + ImperativePolicyDefinition: + type: object + required: + - PolicyParameterID + - PolicyParameterValue + properties: + PolicyParameterID: + type: integer + PolicyParameterValue: + type: integer + SubscriptionInstance: + type: object + required: + - RequestorId + - InstanceId properties: RequestorId: type: integer - TBD: + InstanceId: + type: integer + SubscriptionResponse: + type: object + required: + - SubscriptionId + - SubscriptionInstances + properties: + SubscriptionId: type: string + SubscriptionInstances: + type: array + items: + $ref: '#/definitions/SubscriptionInstance' SubscriptionData: type: object properties: