X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=information-coordinator-service%2Fapi%2Fics-api.json;h=69ad473b666c63cb1ba0101997b154f6a67eb7bd;hb=75123350d6d40767688079d149d26e866ad3d03a;hp=226622c7d7561ae2703a0b91da0413286070f0fa;hpb=5feecd881172a3b22041d35443c1f946e7d5f63e;p=nonrtric.git diff --git a/information-coordinator-service/api/ics-api.json b/information-coordinator-service/api/ics-api.json index 226622c7..69ad473b 100644 --- a/information-coordinator-service/api/ics-api.json +++ b/information-coordinator-service/api/ics-api.json @@ -299,6 +299,13 @@ "description": "Void/empty ", "type": "object" }, + "Link": { + "type": "object", + "properties": { + "templated": {"type": "boolean"}, + "href": {"type": "string"} + } + }, "consumer_type_subscription_info": { "description": "Information for an information type subscription", "type": "object", @@ -369,6 +376,15 @@ }], "tags": ["A1-EI (registration)"] }}, + "/actuator/threaddump": {"get": { + "summary": "Actuator web endpoint 'threaddump'", + "operationId": "threaddump_4", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "tags": ["Actuator"] + }}, "/example_dataproducer/info_job": {"post": { "summary": "Callback for Information Job creation/modification", "requestBody": { @@ -538,6 +554,234 @@ "tags": ["Data consumer"] } }, + "/actuator/loggers": {"get": { + "summary": "Actuator web endpoint 'loggers'", + "operationId": "loggers_2", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "tags": ["Actuator"] + }}, + "/actuator/health/**": {"get": { + "summary": "Actuator web endpoint 'health-path'", + "operationId": "health-path_2", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "tags": ["Actuator"] + }}, + "/data-consumer/v1/info-types": {"get": { + "summary": "Information type identifiers", + "operationId": "getinfoTypeIdentifiers", + "responses": {"200": { + "description": "Information type identifiers", + "content": {"application/json": {"schema": { + "type": "array", + "items": {"type": "string"} + }}} + }}, + "tags": ["Data consumer"] + }}, + "/actuator/metrics/{requiredMetricName}": {"get": { + "summary": "Actuator web endpoint 'metrics-requiredMetricName'", + "operationId": "metrics-requiredMetricName_2", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "parameters": [{ + "schema": {"type": "string"}, + "in": "path", + "name": "requiredMetricName", + "required": true + }], + "tags": ["Actuator"] + }}, + "/actuator": {"get": { + "summary": "Actuator root web endpoint", + "operationId": "links_1", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": { + "additionalProperties": { + "additionalProperties": {"$ref": "#/components/schemas/Link"}, + "type": "object" + }, + "type": "object" + }}} + }}, + "tags": ["Actuator"] + }}, + "/data-consumer/v1/info-jobs": {"get": { + "summary": "Information Job identifiers", + "description": "query for information job identifiers", + "operationId": "getJobIds", + "responses": { + "200": { + "description": "Information information job identifiers", + "content": {"application/json": {"schema": { + "type": "array", + "items": {"type": "string"} + }}} + }, + "404": { + "description": "Information type is not found", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} + } + }, + "parameters": [ + { + "schema": {"type": "string"}, + "in": "query", + "name": "infoTypeId", + "description": "selects subscription jobs of matching information type", + "required": false + }, + { + "schema": {"type": "string"}, + "in": "query", + "name": "owner", + "description": "selects result for one owner", + "required": false + } + ], + "tags": ["Data consumer"] + }}, + "/actuator/loggers/{name}": { + "post": { + "summary": "Actuator web endpoint 'loggers-name'", + "operationId": "loggers-name_3", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "parameters": [{ + "schema": {"type": "string"}, + "in": "path", + "name": "name", + "required": true + }], + "tags": ["Actuator"] + }, + "get": { + "summary": "Actuator web endpoint 'loggers-name'", + "operationId": "loggers-name_4", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "parameters": [{ + "schema": {"type": "string"}, + "in": "path", + "name": "name", + "required": true + }], + "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)"] + }}, + "/A1-EI/v1/eijobs/{eiJobId}/status": {"get": { + "summary": "EI job status", + "operationId": "getEiJobStatus_1", + "responses": { + "200": { + "description": "EI job status", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/EiJobStatusObject"}}} + }, + "404": { + "description": "Enrichment Information job is not found", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} + } + }, + "parameters": [{ + "schema": {"type": "string"}, + "in": "path", + "name": "eiJobId", + "required": true + }], + "tags": ["A1-EI (registration)"] + }}, + "/data-producer/v1/info-producers/{infoProducerId}/status": {"get": { + "summary": "Information producer status", + "operationId": "getInfoProducerStatus", + "responses": { + "200": { + "description": "Information producer status", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/producer_status"}}} + }, + "404": { + "description": "Information producer is not found", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} + } + }, + "parameters": [{ + "schema": {"type": "string"}, + "in": "path", + "name": "infoProducerId", + "required": true + }], + "tags": ["Data producer (registration)"] + }}, + "/data-consumer/v1/info-jobs/{infoJobId}/status": {"get": { + "summary": "Job status", + "operationId": "getEiJobStatus", + "responses": { + "200": { + "description": "Information subscription job status", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/consumer_job_status"}}} + }, + "404": { + "description": "Information subscription job is not found", + "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} + } + }, + "parameters": [{ + "schema": {"type": "string"}, + "in": "path", + "name": "infoJobId", + "required": true + }], + "tags": ["Data consumer"] + }}, + "/actuator/metrics": {"get": { + "summary": "Actuator web endpoint 'metrics'", + "operationId": "metrics_2", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "tags": ["Actuator"] + }}, + "/actuator/info": {"get": { + "summary": "Actuator web endpoint 'info'", + "operationId": "info_2", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "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.", @@ -560,18 +804,6 @@ }}, "tags": ["A1-EI (registration)"] }}, - "/data-consumer/v1/info-types": {"get": { - "summary": "Information type identifiers", - "operationId": "getinfoTypeIdentifiers", - "responses": {"200": { - "description": "Information type identifiers", - "content": {"application/json": {"schema": { - "type": "array", - "items": {"type": "string"} - }}} - }}, - "tags": ["Data consumer"] - }}, "/data-producer/v1/info-producers/{infoProducerId}": { "get": { "summary": "Individual Information Producer", @@ -767,40 +999,14 @@ "tags": ["A1-EI (registration)"] } }, - "/data-consumer/v1/info-jobs": {"get": { - "summary": "Information Job identifiers", - "description": "query for information job identifiers", - "operationId": "getJobIds", - "responses": { - "200": { - "description": "Information information job identifiers", - "content": {"application/json": {"schema": { - "type": "array", - "items": {"type": "string"} - }}} - }, - "404": { - "description": "Information type is not found", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} - } - }, - "parameters": [ - { - "schema": {"type": "string"}, - "in": "query", - "name": "infoTypeId", - "description": "selects subscription jobs of matching information type", - "required": false - }, - { - "schema": {"type": "string"}, - "in": "query", - "name": "owner", - "description": "selects result for one owner", - "required": false - } - ], - "tags": ["Data consumer"] + "/actuator/logfile": {"get": { + "summary": "Actuator web endpoint 'logfile'", + "operationId": "logfile_2", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "tags": ["Actuator"] }}, "/data-consumer/v1/info-jobs/{infoJobId}": { "get": { @@ -940,25 +1146,14 @@ }], "tags": ["Data consumer"] }}, - "/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", + "/actuator/health": {"get": { + "summary": "Actuator web endpoint 'health'", + "operationId": "health_2", "responses": {"200": { "description": "OK", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} + "content": {"*/*": {"schema": {"type": "object"}}} }}, - "parameters": [{ - "schema": {"type": "string"}, - "in": "path", - "name": "infoJobId", - "required": true - }], - "tags": ["A1-EI (callbacks)"] + "tags": ["Actuator"] }}, "/A1-EI/v1/eijobs": {"get": { "summary": "EI job identifiers", @@ -995,48 +1190,6 @@ ], "tags": ["A1-EI (registration)"] }}, - "/A1-EI/v1/eijobs/{eiJobId}/status": {"get": { - "summary": "EI job status", - "operationId": "getEiJobStatus_1", - "responses": { - "200": { - "description": "EI job status", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/EiJobStatusObject"}}} - }, - "404": { - "description": "Enrichment Information job is not found", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} - } - }, - "parameters": [{ - "schema": {"type": "string"}, - "in": "path", - "name": "eiJobId", - "required": true - }], - "tags": ["A1-EI (registration)"] - }}, - "/data-producer/v1/info-producers/{infoProducerId}/status": {"get": { - "summary": "Information producer status", - "operationId": "getInfoProducerStatus", - "responses": { - "200": { - "description": "Information producer status", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/producer_status"}}} - }, - "404": { - "description": "Information producer is not found", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} - } - }, - "parameters": [{ - "schema": {"type": "string"}, - "in": "path", - "name": "infoProducerId", - "required": true - }], - "tags": ["Data producer (registration)"] - }}, "/data-producer/v1/info-producers/{infoProducerId}/info-jobs": {"get": { "summary": "Information Job definitions", "description": "Information Job definitions for one Information Producer", @@ -1062,27 +1215,6 @@ }], "tags": ["Data producer (registration)"] }}, - "/data-consumer/v1/info-jobs/{infoJobId}/status": {"get": { - "summary": "Job status", - "operationId": "getEiJobStatus", - "responses": { - "200": { - "description": "Information subscription job status", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/consumer_job_status"}}} - }, - "404": { - "description": "Information subscription job is not found", - "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ProblemDetails"}}} - } - }, - "parameters": [{ - "schema": {"type": "string"}, - "in": "path", - "name": "infoJobId", - "required": true - }], - "tags": ["Data consumer"] - }}, "/example_dataconsumer/info_type_status": {"post": { "summary": "Callback for changed Information type registration status", "requestBody": { @@ -1096,6 +1228,15 @@ "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Void"}}} }}, "tags": ["Data consumer (callbacks)"] + }}, + "/actuator/heapdump": {"get": { + "summary": "Actuator web endpoint 'heapdump'", + "operationId": "heapdump_2", + "responses": {"200": { + "description": "OK", + "content": {"*/*": {"schema": {"type": "object"}}} + }}, + "tags": ["Actuator"] }} }, "info": { @@ -1108,6 +1249,13 @@ "version": "1.0" }, "tags": [ + {"name": "A1-EI (callbacks)"}, + { + "name": "Data producer (callbacks)", + "description": "API implemented by data producers" + }, + {"name": "Data consumer"}, + {"name": "Data consumer (callbacks)"}, { "name": "A1-EI (registration)", "description": "Data consumer EI job registration" @@ -1116,21 +1264,29 @@ "name": "A1-EI (callbacks)", "description": "Data consumer EI job status callbacks" }, - { - "name": "Data producer (callbacks)", - "description": "API implemented by data producers" - }, + {"name": "Service status"}, + {"name": "A1-EI (registration)"}, + {"name": "Data producer (registration)"}, + {"name": "Data producer (callbacks)"}, { "name": "Data producer (registration)", "description": "API for data producers" }, + { + "name": "Data consumer", + "description": "API for data consumers" + }, { "name": "Service status", "description": "API for monitoring of the service" }, { - "name": "Data consumer", - "description": "API for data consumers" + "name": "Actuator", + "description": "Monitor and interact", + "externalDocs": { + "description": "Spring Boot Actuator Web API Documentation", + "url": "https://docs.spring.io/spring-boot/docs/current/actuator-api/html/" + } } ] } \ No newline at end of file