X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=enrichment-coordinator-service%2Fapi%2Fecs-api.json;h=37416ac8d670926a4ad976a1f03af011091de548;hb=6296305fad90e21103fa92e05e0d21a3ba1356a2;hp=79ab5d354d79e49126a2ba3f94f8497acc0bc178;hpb=bfe1c4049297589c4ade863b12e3d6a6cb7abc99;p=nonrtric.git diff --git a/enrichment-coordinator-service/api/ecs-api.json b/enrichment-coordinator-service/api/ecs-api.json index 79ab5d35..37416ac8 100644 --- a/enrichment-coordinator-service/api/ecs-api.json +++ b/enrichment-coordinator-service/api/ecs-api.json @@ -20,7 +20,7 @@ "description": "request", "required": true }], - "tags": ["Producer Callbacks"], + "tags": ["Data Producer Job Control (example producer)"], "consumes": ["application/json"] }}, "/A1-EI/v1/eitypes/{eiTypeId}": {"get": { @@ -77,7 +77,7 @@ "required": true } ], - "tags": ["Consumer Callbacks"], + "tags": ["A1-EI (enrichment information) callbacks"], "consumes": ["application/json"] }}, "/ei-producer/v1/eitypes": {"get": { @@ -97,7 +97,7 @@ "403": {"description": "Forbidden"}, "404": {"description": "Not Found"} }, - "tags": ["Enrichment Data Producer API"] + "tags": ["Data Producer Registry API"] }}, "/A1-EI/v1/eitypes": {"get": { "summary": "EI type identifiers", @@ -126,7 +126,7 @@ "responses": { "200": { "schema": {"$ref": "#/definitions/producer_status"}, - "description": "EI jobs" + "description": "EI producer status" }, "401": {"description": "Unauthorized"}, "403": {"description": "Forbidden"}, @@ -142,7 +142,7 @@ "type": "string", "required": true }], - "tags": ["Enrichment Data Producer API"] + "tags": ["Data Producer Registry API"] }}, "/producer_simulator/ei_job/{eiJobId}": {"delete": { "summary": "Callback for EI job deletion", @@ -162,7 +162,7 @@ "type": "string", "required": true }], - "tags": ["Producer Callbacks"] + "tags": ["Data Producer Job Control (example producer)"] }}, "/ei-producer/v1/eiproducers": {"get": { "summary": "EI producer identifiers", @@ -181,34 +181,107 @@ "403": {"description": "Forbidden"}, "404": {"description": "Not Found"} }, - "tags": ["Enrichment Data Producer API"] - }}, - "/ei-producer/v1/eitypes/{eiTypeId}": {"get": { - "summary": "Individual EI type", - "deprecated": false, - "produces": ["application/json"], - "operationId": "getEiTypeUsingGET_1", - "responses": { - "200": { - "schema": {"$ref": "#/definitions/producer_ei_type_info"}, - "description": "EI type" - }, - "401": {"description": "Unauthorized"}, - "403": {"description": "Forbidden"}, - "404": { - "schema": {"$ref": "#/definitions/ProblemDetails"}, - "description": "Enrichment Information type is not found" - } - }, "parameters": [{ - "in": "path", - "name": "eiTypeId", - "description": "eiTypeId", + "in": "query", + "allowEmptyValue": false, + "name": "ei_type_id", + "description": "If given, only the producers for the EI Data type is returned.", "type": "string", - "required": true + "required": false }], - "tags": ["Enrichment Data Producer API"] + "tags": ["Data Producer Registry API"] }}, + "/ei-producer/v1/eitypes/{eiTypeId}": { + "get": { + "summary": "Individual EI type", + "deprecated": false, + "produces": ["application/json"], + "operationId": "getEiTypeUsingGET_1", + "responses": { + "200": { + "schema": {"$ref": "#/definitions/producer_ei_type_info"}, + "description": "EI type" + }, + "401": {"description": "Unauthorized"}, + "403": {"description": "Forbidden"}, + "404": { + "schema": {"$ref": "#/definitions/ProblemDetails"}, + "description": "Enrichment Information type is not found" + } + }, + "parameters": [{ + "in": "path", + "name": "eiTypeId", + "description": "eiTypeId", + "type": "string", + "required": true + }], + "tags": ["Data Producer Registry API"] + }, + "delete": { + "summary": "Individual EI type", + "deprecated": false, + "produces": ["application/json"], + "operationId": "deleteEiTypeUsingDELETE", + "responses": { + "200": {"description": "Not used"}, + "401": {"description": "Unauthorized"}, + "204": {"description": "Producer deleted"}, + "403": {"description": "Forbidden"}, + "404": { + "schema": {"$ref": "#/definitions/ProblemDetails"}, + "description": "Enrichment Information type is not found" + }, + "406": { + "schema": {"$ref": "#/definitions/ProblemDetails"}, + "description": "The Enrichment Information type has one or several active producers" + } + }, + "parameters": [{ + "in": "path", + "name": "eiTypeId", + "description": "eiTypeId", + "type": "string", + "required": true + }], + "tags": ["Data Producer Registry API"] + }, + "put": { + "summary": "Individual EI type", + "deprecated": false, + "produces": ["application/json"], + "operationId": "putEiTypeUsingPUT", + "responses": { + "200": {"description": "Type updated"}, + "201": {"description": "Type created"}, + "400": { + "schema": {"$ref": "#/definitions/ProblemDetails"}, + "description": "Bad request" + }, + "401": {"description": "Unauthorized"}, + "403": {"description": "Forbidden"}, + "404": {"description": "Not Found"} + }, + "parameters": [ + { + "in": "path", + "name": "eiTypeId", + "description": "eiTypeId", + "type": "string", + "required": true + }, + { + "schema": {"$ref": "#/definitions/producer_ei_type_info"}, + "in": "body", + "name": "registrationInfo", + "description": "registrationInfo", + "required": true + } + ], + "tags": ["Data Producer Registry API"], + "consumes": ["application/json"] + } + }, "/status": {"get": { "summary": "Returns status and statistics of this service", "deprecated": false, @@ -320,7 +393,7 @@ "responses": { "200": { "schema": {"$ref": "#/definitions/producer_registration_info"}, - "description": "EI jobs" + "description": "EI producer" }, "401": {"description": "Unauthorized"}, "403": {"description": "Forbidden"}, @@ -336,7 +409,7 @@ "type": "string", "required": true }], - "tags": ["Enrichment Data Producer API"] + "tags": ["Data Producer Registry API"] }, "delete": { "summary": "Individual EI producer", @@ -360,7 +433,7 @@ "type": "string", "required": true }], - "tags": ["Enrichment Data Producer API"] + "tags": ["Data Producer Registry API"] }, "put": { "summary": "Individual EI producer", @@ -390,7 +463,7 @@ "required": true } ], - "tags": ["Enrichment Data Producer API"], + "tags": ["Data Producer Registry API"], "consumes": ["application/json"] } }, @@ -408,7 +481,7 @@ "403": {"description": "Forbidden"}, "404": {"description": "Not Found"} }, - "tags": ["Producer Callbacks"] + "tags": ["Data Producer Job Control (example producer)"] }}, "/ei-producer/v1/eiproducers/{eiProducerId}/eijobs": {"get": { "summary": "EI job definitions", @@ -422,7 +495,7 @@ "type": "array", "items": {"$ref": "#/definitions/producer_ei_job_request"} }, - "description": "EI jobs" + "description": "EI producer" }, "401": {"description": "Unauthorized"}, "403": {"description": "Forbidden"}, @@ -438,7 +511,7 @@ "type": "string", "required": true }], - "tags": ["Enrichment Data Producer API"] + "tags": ["Data Producer Registry API"] }}, "/A1-EI/v1/eijobs": {"get": { "summary": "EI job identifiers", @@ -523,6 +596,10 @@ "description": "Idenitity of the EI job", "type": "string" }, + "last_updated": { + "description": "The time when the job was last updated or created (ISO-8601)", + "type": "string" + }, "ei_job_data": { "description": "Json for the job data", "type": "object" @@ -542,22 +619,6 @@ "type": "object", "title": "EiTypeObject" }, - "producer_ei_type_registration_info": { - "description": "Information for an EI type", - "type": "object", - "title": "producer_ei_type_registration_info", - "required": ["ei_type_identity"], - "properties": { - "ei_type_identity": { - "description": "EI type identity", - "type": "string" - }, - "ei_job_data_schema": { - "description": "Json schema for the job data", - "type": "object" - } - } - }, "status_info": { "type": "object", "title": "status_info", @@ -583,25 +644,15 @@ } } }, - "Mono«ResponseEntity«object»»": { - "type": "object", - "title": "Mono«ResponseEntity«object»»" - }, "producer_ei_type_info": { "description": "Information for an EI type", "type": "object", "title": "producer_ei_type_info", - "properties": { - "ei_producer_ids": { - "description": "Registered producers", - "type": "array", - "items": {"type": "string"} - }, - "ei_job_data_schema": { - "description": "Json schema for the job data", - "type": "object" - } - } + "required": ["ei_job_data_schema"], + "properties": {"ei_job_data_schema": { + "description": "Json schema for the job data", + "type": "object" + }} }, "producer_registration_info": { "description": "Information for an EI producer", @@ -614,9 +665,9 @@ ], "properties": { "supported_ei_types": { - "description": "Supported EI types", + "description": "Supported EI type IDs", "type": "array", - "items": {"$ref": "#/definitions/producer_ei_type_registration_info"} + "items": {"type": "string"} }, "ei_producer_supervision_callback_url": { "description": "callback for producer supervision", @@ -660,11 +711,6 @@ } } }, - "Void": { - "description": "Void/empty", - "type": "object", - "title": "Void" - }, "EiJobStatusObject": { "description": "Status for an EI job", "type": "object", @@ -725,16 +771,16 @@ "description": "Consumer Controller" }, { - "name": "Consumer Callbacks", + "name": "A1-EI (enrichment information) callbacks", "description": "Consumer Simulator Controller" }, { - "name": "Enrichment Data Producer API", - "description": "Producer Controller" + "name": "Data Producer Job Control (example producer)", + "description": "Producer Simulator Controller" }, { - "name": "Producer Callbacks", - "description": "Producer Simulator Controller" + "name": "Data Producer Registry API", + "description": "Producer Controller" }, { "name": "Service status",