X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=dmaap-adaptor-java%2Fapi%2Fapi.yaml;h=f6eb1f7f488e5c100176e70f6ea6de0f7eaf64b6;hb=21c2d3065fdf0d8b8c8680d292b524248622875f;hp=b3acfdaf9d59bc53c55d1dd112d49e59a3e14bde;hpb=242299199382ec3fd7d514dde2eb607086a6a46e;p=nonrtric.git diff --git a/dmaap-adaptor-java/api/api.yaml b/dmaap-adaptor-java/api/api.yaml index b3acfdaf..f6eb1f7f 100644 --- a/dmaap-adaptor-java/api/api.yaml +++ b/dmaap-adaptor-java/api/api.yaml @@ -1,7 +1,8 @@ openapi: 3.0.1 info: - title: Generic Dmaap Information Producer - description: Reads data from DMAAP and sends it further to information consumers + title: Generic Dmaap and Kafka Information Producer + description: Reads data from DMaaP and Kafka and posts it further to information + consumers license: name: Copyright (C) 2021 Nordix Foundation. Licensed under the Apache License. url: http://www.apache.org/licenses/LICENSE-2.0 @@ -9,81 +10,22 @@ info: servers: - url: / tags: +- name: Information Coordinator Service Simulator (exists only in test) +- name: Producer job control API +- name: Test Consumer Simulator (exists only in test) +- name: DMAAP Simulator (exists only in test) - 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/ paths: - /dmaap_dataproducer/info_job: - get: - tags: - - Producer job control API - summary: Get all jobs - description: Returns all info jobs, can be used for trouble shooting - operationId: getJobs - responses: - 200: - description: Information jobs - content: - application/json: - schema: - type: array - items: - $ref: '#/components/schemas/producer_info_job_request' - post: - tags: - - Producer job control API - summary: Callback for Information Job creation/modification - description: The call is invoked to activate or to modify a data subscription. - The endpoint is provided by the Information Producer. - operationId: jobCreatedCallback - requestBody: - content: - application/json: - schema: - type: string - required: true - responses: - 200: - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/void' - 400: - description: Other error in the request - content: - application/json: - schema: - $ref: '#/components/schemas/error_information' - 404: - description: Information type is not found - content: - application/json: - schema: - $ref: '#/components/schemas/error_information' - /dmaap_dataproducer/health_check: - get: - tags: - - Producer job control API - 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 /actuator/threaddump: get: tags: - Actuator summary: Actuator web endpoint 'threaddump' - operationId: handle_2_1_3 + operationId: threaddump_4 responses: 200: description: OK @@ -96,7 +38,7 @@ paths: tags: - Actuator summary: Actuator web endpoint 'info' - operationId: handle_9 + operationId: info_2 responses: 200: description: OK @@ -130,12 +72,75 @@ paths: application/json: schema: type: object + /generic_dataproducer/health_check: + get: + tags: + - Producer job control API + 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 + /generic_dataproducer/info_job: + get: + tags: + - Producer job control API + summary: Get all jobs + description: Returns all info jobs, can be used for trouble shooting + operationId: getJobs + responses: + 200: + description: Information jobs + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/producer_info_job_request' + post: + tags: + - Producer job control API + summary: Callback for Information Job creation/modification + description: The call is invoked to activate or to modify a data subscription. + The endpoint is provided by the Information Producer. + operationId: jobCreatedCallback + requestBody: + content: + application/json: + schema: + type: string + required: true + responses: + 200: + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/void' + 400: + description: Other error in the request + content: + application/json: + schema: + $ref: '#/components/schemas/error_information' + 404: + description: Information type is not found + content: + application/json: + schema: + $ref: '#/components/schemas/error_information' /actuator/loggers: get: tags: - Actuator summary: Actuator web endpoint 'loggers' - operationId: handle_6 + operationId: loggers_2 responses: 200: description: OK @@ -148,7 +153,7 @@ paths: tags: - Actuator summary: Actuator web endpoint 'health-path' - operationId: handle_12 + operationId: health-path_2 responses: 200: description: OK @@ -201,12 +206,35 @@ paths: application/json: schema: type: object + /generic_dataproducer/info_job/{infoJobId}: + delete: + tags: + - Producer job control API + 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 + parameters: + - name: infoJobId + in: path + required: true + style: simple + explode: false + schema: + type: string + responses: + 200: + description: OK + content: + application/json: + schema: + $ref: '#/components/schemas/void' /actuator/metrics/{requiredMetricName}: get: tags: - Actuator summary: Actuator web endpoint 'metrics-requiredMetricName' - operationId: handle_5 + operationId: metrics-requiredMetricName_2 parameters: - name: requiredMetricName in: path @@ -244,7 +272,7 @@ paths: tags: - Actuator summary: Actuator web endpoint 'logfile' - operationId: handle_8 + operationId: logfile_2 responses: 200: description: OK @@ -257,7 +285,7 @@ paths: tags: - Actuator summary: Actuator web endpoint 'loggers-name' - operationId: handle_7 + operationId: loggers-name_4 parameters: - name: name in: path @@ -277,7 +305,7 @@ paths: tags: - Actuator summary: Actuator web endpoint 'loggers-name' - operationId: handle_0 + operationId: loggers-name_3 parameters: - name: name in: path @@ -293,35 +321,12 @@ paths: '*/*': schema: type: object - /dmaap_dataproducer/info_job/{infoJobId}: - delete: - tags: - - Producer job control API - 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 - parameters: - - name: infoJobId - in: path - required: true - style: simple - explode: false - schema: - type: string - responses: - 200: - description: OK - content: - application/json: - schema: - $ref: '#/components/schemas/void' /actuator/health: get: tags: - Actuator summary: Actuator web endpoint 'health' - operationId: handle_11 + operationId: health_2 responses: 200: description: OK @@ -369,7 +374,7 @@ paths: tags: - Actuator summary: Actuator web endpoint 'metrics' - operationId: handle_4 + operationId: metrics_2 responses: 200: description: OK @@ -382,7 +387,7 @@ paths: tags: - Actuator summary: Actuator web endpoint 'heapdump' - operationId: handle_10 + operationId: heapdump_2 responses: 200: description: OK