From: Henrik Andersson Date: Mon, 14 Feb 2022 16:14:54 +0000 (+0000) Subject: Merge "NONRTRIC - 3PP dependency version update" X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=commitdiff_plain;h=66d3c321ff4f020814fe99e548740d0b7c7d5a85;hp=3b5e61a676c484ff7aa244bf453bdb384ab0a0a7;p=nonrtric.git Merge "NONRTRIC - 3PP dependency version update" --- diff --git a/information-coordinator-service/api/ics-api.json b/information-coordinator-service/api/ics-api.json index 69ad473b..082d42f5 100644 --- a/information-coordinator-service/api/ics-api.json +++ b/information-coordinator-service/api/ics-api.json @@ -327,22 +327,6 @@ }}, "openapi": "3.0.1", "paths": { - "/example_dataproducer/info_job/{infoJobId}": {"delete": { - "summary": "Callback for Information Job deletion", - "description": "The call is invoked to terminate a data subscription. The endpoint is provided by the Information Producer.", - "operationId": "jobDeletedCallback", - "responses": {"200": { - "description": "OK", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} - }}, - "parameters": [{ - "schema": {"type": "string"}, - "in": "path", - "name": "infoJobId", - "required": true - }], - "tags": ["Data producer (callbacks)"] - }}, "/data-producer/v1/info-types": {"get": { "summary": "Info Type identifiers", "operationId": "getInfoTypdentifiers", @@ -385,20 +369,6 @@ }}, "tags": ["Actuator"] }}, - "/example_dataproducer/info_job": {"post": { - "summary": "Callback for Information Job creation/modification", - "requestBody": { - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/producer_info_job_request"}}}, - "required": true - }, - "description": "The call is invoked to activate or to modify a data subscription. The endpoint is provided by the Information Producer.", - "operationId": "jobCreatedCallback", - "responses": {"200": { - "description": "OK", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} - }}, - "tags": ["Data producer (callbacks)"] - }}, "/data-producer/v1/info-types/{infoTypeId}": { "get": { "summary": "Individual Information Type", @@ -554,6 +524,16 @@ "tags": ["Data consumer"] } }, + "/example-dataproducer/health-check": {"get": { + "summary": "Producer supervision", + "description": "The endpoint is provided by the Information Producer and is used for supervision of the producer.", + "operationId": "producerSupervision", + "responses": {"200": { + "description": "The producer is OK", + "content": {"application/json": {"schema": {"type": "string"}}} + }}, + "tags": ["Data producer (callbacks)"] + }}, "/actuator/loggers": {"get": { "summary": "Actuator web endpoint 'loggers'", "operationId": "loggers_2", @@ -584,6 +564,20 @@ }}, "tags": ["Data consumer"] }}, + "/example-dataconsumer/info-type-status": {"post": { + "summary": "Callback for changed Information type registration status", + "requestBody": { + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/consumer_type_registration_info"}}}, + "required": true + }, + "description": "The primitive is implemented by the data consumer and is invoked when a Information type status has been changed.
Subscription are managed by primitives in 'Data consumer'", + "operationId": "typeStatusCallback", + "responses": {"200": { + "description": "OK", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} + }}, + "tags": ["Data consumer (callbacks)"] + }}, "/actuator/metrics/{requiredMetricName}": {"get": { "summary": "Actuator web endpoint 'metrics-requiredMetricName'", "operationId": "metrics-requiredMetricName_2", @@ -681,14 +675,24 @@ "tags": ["Actuator"] } }, - "/example_dataconsumer/info_jobs/{infoJobId}/status": {"post": { - "summary": "Callback for changed Information Job status", + "/example-dataproducer/info-job": {"post": { + "summary": "Callback for Information Job creation/modification", "requestBody": { - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/EiJobStatusObject"}}}, + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/producer_info_job_request"}}}, "required": true }, - "description": "The primitive is implemented by the data consumer and is invoked when a Information Job status has been changed.", - "operationId": "jobStatusCallback", + "description": "The call is invoked to activate or to modify a data subscription. The endpoint is provided by the Information Producer.", + "operationId": "jobCreatedCallback", + "responses": {"200": { + "description": "OK", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} + }}, + "tags": ["Data producer (callbacks)"] + }}, + "/example-dataproducer/info-job/{infoJobId}": {"delete": { + "summary": "Callback for Information Job deletion", + "description": "The call is invoked to terminate a data subscription. The endpoint is provided by the Information Producer.", + "operationId": "jobDeletedCallback", "responses": {"200": { "description": "OK", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} @@ -699,7 +703,7 @@ "name": "infoJobId", "required": true }], - "tags": ["A1-EI (callbacks)"] + "tags": ["Data producer (callbacks)"] }}, "/A1-EI/v1/eijobs/{eiJobId}/status": {"get": { "summary": "EI job status", @@ -773,6 +777,26 @@ }}, "tags": ["Actuator"] }}, + "/example-dataconsumer/info-jobs/{infoJobId}/status": {"post": { + "summary": "Callback for changed Information Job status", + "requestBody": { + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/EiJobStatusObject"}}}, + "required": true + }, + "description": "The primitive is implemented by the data consumer and is invoked when a Information Job status has been changed.", + "operationId": "jobStatusCallback", + "responses": {"200": { + "description": "OK", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} + }}, + "parameters": [{ + "schema": {"type": "string"}, + "in": "path", + "name": "infoJobId", + "required": true + }], + "tags": ["A1-EI (callbacks)"] + }}, "/actuator/info": {"get": { "summary": "Actuator web endpoint 'info'", "operationId": "info_2", @@ -782,16 +806,6 @@ }}, "tags": ["Actuator"] }}, - "/example_dataproducer/health_check": {"get": { - "summary": "Producer supervision", - "description": "The endpoint is provided by the Information Producer and is used for supervision of the producer.", - "operationId": "producerSupervision", - "responses": {"200": { - "description": "The producer is OK", - "content": {"application/json": {"schema": {"type": "string"}}} - }}, - "tags": ["Data producer (callbacks)"] - }}, "/A1-EI/v1/eitypes": {"get": { "summary": "EI type identifiers", "operationId": "getEiTypeIdentifiers", @@ -1119,7 +1133,7 @@ "parameters": [{ "schema": {"type": "string"}, "in": "query", - "name": "info_type_id", + "name": "infoTypeId", "description": "If given, only the producers for the EI Data type is returned.", "required": false }], @@ -1215,20 +1229,6 @@ }], "tags": ["Data producer (registration)"] }}, - "/example_dataconsumer/info_type_status": {"post": { - "summary": "Callback for changed Information type registration status", - "requestBody": { - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/consumer_type_registration_info"}}}, - "required": true - }, - "description": "The primitive is implemented by the data consumer and is invoked when a Information type status has been changed.
Subscription are managed by primitives in 'Data consumer'", - "operationId": "typeStatusCallback", - "responses": {"200": { - "description": "OK", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} - }}, - "tags": ["Data consumer (callbacks)"] - }}, "/actuator/heapdump": {"get": { "summary": "Actuator web endpoint 'heapdump'", "operationId": "heapdump_2", @@ -1241,7 +1241,7 @@ }, "info": { "license": { - "name": "Copyright (C) 2020 Nordix Foundation. Licensed under the Apache License.", + "name": "Copyright (C) 2020-2022 Nordix Foundation. Licensed under the Apache License.", "url": "http://www.apache.org/licenses/LICENSE-2.0" }, "description": "

API documentation<\/h1>

General<\/h2>

The service is mainly a broker between data producers and data consumers. A data producer has the ability to produce one or several types of data (Information Type). One type of data can be produced by zero to many producers.

A data consumer can have several active data subscriptions (Information Job). One Information Job consists of the type of data to produce and additional parameters for filtering of the data. These parameters are different for different data types.<\/p>

APIs provided by the service<\/h2>

A1-EI<\/h4>

This API is between Near-RT RIC and the Non-RT RIC. The Near-RT RIC is a data consumer, which creates Information Jobs to subscribe for data. In this context, the information is referred to as 'Enrichment Information', EI.<\/p>

Data producer API<\/h4>

This API is provided by the Non-RT RIC platform and is intended to be part of the O-RAN R1 interface. The API is for use by different kinds of data producers and provides support for: