X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;ds=sidebyside;f=api%2Fxapp_rest_api.yaml;h=38a34f960a3e89638ca60f887d310444551c6477;hb=refs%2Fchanges%2F57%2F6157%2F1;hp=74db6b97949659240c092bdde8c69c579e7e74ad;hpb=3602bf801fef17e317cb35a4c710118ec80908b9;p=ric-plt%2Fxapp-frame.git diff --git a/api/xapp_rest_api.yaml b/api/xapp_rest_api.yaml old mode 100755 new mode 100644 index 74db6b9..38a34f9 --- a/api/xapp_rest_api.yaml +++ b/api/xapp_rest_api.yaml @@ -1,7 +1,7 @@ -swagger: "2.0" +swagger: '2.0' info: description: This is the initial REST API for RIC subscription - version: 0.0.1 + version: 0.0.2 title: RIC subscription license: name: Apache 2.0 @@ -31,7 +31,7 @@ paths: get: summary: Returns list of subscriptions tags: - - "common" + - common operationId: getAllSubscriptions produces: - application/json @@ -44,7 +44,7 @@ paths: description: Internal error post: tags: - - "common" + - common operationId: Subscribe summary: Subscribe a list of X2AP event triggers to receive messages sent by RAN consumes: @@ -69,7 +69,7 @@ paths: '/subscriptions/{subscriptionId}': delete: tags: - - "common" + - common summary: Unsubscribe X2AP events from Subscription Manager operationId: Unsubscribe consumes: @@ -103,9 +103,9 @@ definitions: type: string description: The type of the content enum: - - json - - xml - - other + - json + - xml + - other XAppConfig: type: object required: @@ -121,7 +121,6 @@ definitions: type: array items: $ref: '#/definitions/XAppConfig' - ActionDefinition: type: object description: E2SM Octet string. ActionDefinition is an OPTIONAL IE @@ -191,54 +190,57 @@ definitions: properties: OctetString: type: string - SubscriptionDetails: + SubscriptionDetail: type: object required: - - EventTriggerList + - XappEventInstanceId + - EventTriggers - ActionToBeSetupList properties: - EventTriggerList: + XappEventInstanceId: + type: integer + minimum: 0 + maximum: 65535 + EventTriggers: $ref: '#/definitions/EventTriggerDefinition' ActionToBeSetupList: $ref: '#/definitions/ActionsToBeSetup' SubscriptionDetailsList: type: array items: - $ref: '#/definitions/SubscriptionDetails' + $ref: '#/definitions/SubscriptionDetail' SubscriptionParams: type: object required: - ClientEndpoint - Meid - - RequestorId - - InstanceId - RANFunctionID - SubscriptionDetails properties: + SubscriptionId: + type: string + description: Optional subscription ID (Submgr allocates if not given) ClientEndpoint: type: object description: xApp service address and port properties: - ServiceName: + Host: description: >- xApp service address name like 'service-ricxapp-xappname-http.ricxapp' type: string - Port: - description: xApp service address port + 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 - RequestorId: - type: integer - minimum: 0 - maximum: 65535 - InstanceId: - type: integer - minimum: 0 - maximum: 65535 RANFunctionID: type: integer minimum: 0 @@ -260,22 +262,21 @@ definitions: SubscriptionInstance: type: object required: - - RequestorId - - InstanceId + - XappEventInstanceId + - E2EventInstanceId - ErrorCause properties: - RequestorId: + XappEventInstanceId: type: integer minimum: 0 maximum: 65535 - InstanceId: + E2EventInstanceId: type: integer minimum: 0 maximum: 65535 ErrorCause: description: Empty string when no error. type: string - SubscriptionData: type: object properties: @@ -283,12 +284,16 @@ definitions: 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 items: - $ref: '#/definitions/SubscriptionData' \ No newline at end of file + $ref: '#/definitions/SubscriptionData'