3 title: Data management and exposure
4 description: <h1>API documentation</h1><h2>General</h2><p> The service is mainly
5 a broker between data producers and data consumers. A data producer has the ability
6 to produce one or several types of data (EI type). One type of data can be produced
7 by zero to many producers. <br /><br />A data consumer can have several active
8 data subscriptions (EI job). One EI job consists of the type of data to produce
9 and additional parameters for filtering of the data. These parameters are different
10 for different data types.</p><h2>APIs provided by the service</h2><h4>A1-EI</h4><p> This
11 API is between Near-RT RIC and the Non-RT RIC. The Near-RT RIC is a data consumer,
12 which creates Enrichment Information Jobs to subscribe for data.</p><h4>Data producer
13 API</h4><p> This API is provided by the Non-RT RIC platform and is intended to
14 be part of the O-RAN R1 interface. The API is for use by different kinds of data
15 producers and provides support for:<ul><li>Registry of supported information types
16 and which parameters needed to setup a subscription.</li><li>Registry of existing
17 data producers.</li><li>Callback API provided by producers to setup subscriptions.</li></ul></p><h4>Data
18 consumer API</h4><p> This API is provided by the Non-RT RIC platform and is intended
19 to be part of the O-RAN R1 interface. The API is for use by different kinds of
20 data consumers and provides support for:<ul><li>Querying of available types of
21 data to consume.</li><li>Management of data subscription jobs</li></ul></p><h4>EI
22 Service status</h4><p> This API provides a means to monitor the service.</p>
24 name: Copyright (C) 2020 Nordix Foundation. Licensed under the Apache License.
25 url: http://www.apache.org/licenses/LICENSE-2.0
30 - name: A1-EI (registration)
31 description: Data consumer EI job registration
32 - name: A1-EI (callbacks)
33 description: Data consumer EI job status callbacks
34 - name: Data producer (callbacks)
35 description: API implemented by data producers
36 - name: Data producer (registration)
37 description: API for data producers
38 - name: Service status
39 description: API for monitoring of the service
41 description: API for data consumers
43 /producer_simulator/ei_job:
46 - Data producer (callbacks)
47 summary: Callback for EI job creation/modification
48 description: The call is invoked to activate or to modify a data subscription.
49 The endpoint is provided by the EI producer.
50 operationId: jobCreatedCallback
55 $ref: '#/components/schemas/producer_ei_job_request'
63 $ref: '#/components/schemas/Void'
64 /A1-EI/v1/eitypes/{eiTypeId}:
67 - A1-EI (registration)
68 summary: Individual EI type
69 operationId: getEiType_1
84 $ref: '#/components/schemas/EiTypeObject'
86 description: Enrichment Information type is not found
90 $ref: '#/components/schemas/ProblemDetails'
91 /ei-producer/v1/eitypes:
94 - Data producer (registration)
95 summary: EI type identifiers
96 operationId: getEiTypeIdentifiers
99 description: EI type identifiers
109 - A1-EI (registration)
110 summary: EI type identifiers
111 operationId: getEiTypeIdentifiers_1
114 description: EI type identifiers
121 /data-consumer/v1/info-types:
125 summary: Information type identifiers
126 operationId: getinfoTypeIdentifiers
129 description: Information type identifiers
136 /ei-producer/v1/eiproducers/{eiProducerId}/status:
139 - Data producer (registration)
140 summary: EI producer status
141 operationId: getEiProducerStatus
152 description: EI producer status
156 $ref: '#/components/schemas/producer_status'
158 description: Enrichment Information producer is not found
162 $ref: '#/components/schemas/ProblemDetails'
163 /producer_simulator/ei_job/{eiJobId}:
166 - Data producer (callbacks)
167 summary: Callback for EI job deletion
168 description: The call is invoked to terminate a data subscription. The endpoint
169 is provided by the EI producer.
170 operationId: jobDeletedCallback
185 $ref: '#/components/schemas/Void'
186 /ei-producer/v1/eitypes/{eiTypeId}:
189 - Data producer (registration)
190 summary: Individual EI type
191 operationId: getEiType
206 $ref: '#/components/schemas/producer_ei_type_info'
208 description: Enrichment Information type is not found
212 $ref: '#/components/schemas/ProblemDetails'
215 - Data producer (registration)
216 summary: Individual EI type
217 operationId: putEiType
230 $ref: '#/components/schemas/producer_ei_type_info'
234 description: Type updated
238 $ref: '#/components/schemas/Void'
240 description: Type created
244 $ref: '#/components/schemas/Void'
246 description: Bad request
250 $ref: '#/components/schemas/ProblemDetails'
253 - Data producer (registration)
254 summary: Individual EI type
255 operationId: deleteEiType
266 description: Not used
270 $ref: '#/components/schemas/Void'
272 description: Producer deleted
276 $ref: '#/components/schemas/Void'
278 description: Enrichment Information type is not found
282 $ref: '#/components/schemas/ProblemDetails'
284 description: The Enrichment Information type has one or several active producers
288 $ref: '#/components/schemas/ProblemDetails'
293 summary: Returns status and statistics of this service
294 operationId: getStatus
297 description: Service is living
301 $ref: '#/components/schemas/status_info'
302 /ei-producer/v1/eiproducers:
305 - Data producer (registration)
306 summary: EI producer identifiers
307 operationId: getEiProducerIdentifiers
311 description: If given, only the producers for the EI Data type is returned.
319 description: EI producer identifiers
326 /A1-EI/v1/eijobs/{eiJobId}:
329 - A1-EI (registration)
330 summary: Individual EI job
331 operationId: getIndividualEiJob_1
346 $ref: '#/components/schemas/EiJobObject'
348 description: Enrichment Information job is not found
352 $ref: '#/components/schemas/ProblemDetails'
355 - A1-EI (registration)
356 summary: Individual EI job
357 operationId: putIndividualEiJob
370 $ref: '#/components/schemas/EiJobObject'
374 description: Job updated
378 $ref: '#/components/schemas/Void'
380 description: Job created
384 $ref: '#/components/schemas/Void'
386 description: Enrichment Information type is not found
390 $ref: '#/components/schemas/ProblemDetails'
393 - A1-EI (registration)
394 summary: Individual EI job
395 operationId: deleteIndividualEiJob_1
406 description: Not used
410 $ref: '#/components/schemas/Void'
412 description: Job deleted
416 $ref: '#/components/schemas/Void'
418 description: Enrichment Information job is not found
422 $ref: '#/components/schemas/ProblemDetails'
423 /ei-producer/v1/eiproducers/{eiProducerId}:
426 - Data producer (registration)
427 summary: Individual EI producer
428 operationId: getEiProducer
439 description: EI producer
443 $ref: '#/components/schemas/producer_registration_info'
445 description: Enrichment Information producer is not found
449 $ref: '#/components/schemas/ProblemDetails'
452 - Data producer (registration)
453 summary: Individual EI producer
454 operationId: putEiProducer
467 $ref: '#/components/schemas/producer_registration_info'
471 description: Producer updated
475 $ref: '#/components/schemas/Void'
477 description: Producer created
481 $ref: '#/components/schemas/Void'
483 description: Producer not found
487 $ref: '#/components/schemas/ProblemDetails'
490 - Data producer (registration)
491 summary: Individual EI producer
492 operationId: deleteEiProducer
503 description: Not used
507 $ref: '#/components/schemas/Void'
509 description: Producer deleted
513 $ref: '#/components/schemas/Void'
515 description: Producer is not found
519 $ref: '#/components/schemas/ProblemDetails'
520 /producer_simulator/health_check:
523 - Data producer (callbacks)
524 summary: Producer supervision
525 description: The endpoint is provided by the EI producer and is used for supervision
527 operationId: producerSupervision
530 description: The producer is OK
535 /data-consumer/v1/info-jobs:
539 summary: EI job identifiers
540 description: query for information job identifiers
541 operationId: getJobIds
545 description: selects subscription jobs of matching information type
553 description: selects subscription jobs for one job owner
561 description: Information information job identifiers
569 description: Information type is not found
573 $ref: '#/components/schemas/ProblemDetails'
574 /data-consumer/v1/info-jobs/{infoJobId}:
578 summary: Individual data subscription job
579 operationId: getIndividualEiJob
590 description: Information subscription job
594 $ref: '#/components/schemas/Job'
596 description: Information subscription job is not found
600 $ref: '#/components/schemas/ProblemDetails'
604 summary: Individual data subscription job
605 operationId: putIndividualInfoJob
618 $ref: '#/components/schemas/Job'
622 description: Job updated
626 $ref: '#/components/schemas/Void'
628 description: Job created
632 $ref: '#/components/schemas/Void'
634 description: Enrichment Information type is not found
638 $ref: '#/components/schemas/ProblemDetails'
642 summary: Individual data subscription job
643 operationId: deleteIndividualEiJob
654 description: Not used
658 $ref: '#/components/schemas/Void'
660 description: Job deleted
664 $ref: '#/components/schemas/Void'
666 description: Information subscription job is not found
670 $ref: '#/components/schemas/ProblemDetails'
671 /ei-producer/v1/eiproducers/{eiProducerId}/eijobs:
674 - Data producer (registration)
675 summary: EI job definitions
676 description: EI job definitions for one EI producer
677 operationId: getEiProducerJobs
688 description: EI producer
694 $ref: '#/components/schemas/producer_ei_job_request'
696 description: Enrichment Information producer is not found
700 $ref: '#/components/schemas/ProblemDetails'
701 /data-consumer/v1/info-types/{infoTypeId}:
705 summary: Individual information type
706 operationId: getInfoType
717 description: Information type
721 $ref: '#/components/schemas/InformationType'
723 description: Information type is not found
727 $ref: '#/components/schemas/ProblemDetails'
731 - A1-EI (registration)
732 summary: EI job identifiers
733 description: query for EI job identifiers
734 operationId: getEiJobIds
738 description: selects EI jobs of matching EI type
746 description: selects EI jobs for one EI job owner
754 description: EI job identifiers
762 description: Enrichment Information type is not found
766 $ref: '#/components/schemas/ProblemDetails'
767 /A1-EI/v1/eijobs/{eiJobId}/status:
770 - A1-EI (registration)
771 summary: EI job status
772 operationId: getEiJobStatus_1
783 description: EI job status
787 $ref: '#/components/schemas/EiJobStatusObject'
789 description: Enrichment Information job is not found
793 $ref: '#/components/schemas/ProblemDetails'
794 /example_dataconsumer/eijobs/{eiJobId}/status:
798 summary: Callback for changed EI job status
799 description: The primitive is implemented by the data consumer and is invoked
800 when a EI job status has been changed.
801 operationId: jobStatusCallback
814 $ref: '#/components/schemas/EiJobStatusObject'
822 $ref: '#/components/schemas/Void'
823 /data-consumer/v1/info-jobs/{infoJobId}/status:
828 operationId: getEiJobStatus
839 description: Information subscription job status
843 $ref: '#/components/schemas/JobStatus'
845 description: Information subscription job is not found
849 $ref: '#/components/schemas/ProblemDetails'
852 producer_ei_job_request:
859 description: The owner of the job
862 description: Idenitity of the EI job
865 description: The time when the job was last updated or created (ISO-8601)
868 description: Json for the job data
871 description: URI for the target of the EI
874 description: Type idenitity for the job
875 description: The body of the EI producer callbacks for EI job creation and deletion
878 description: Information for an EI type
889 description: Number of EI producers
893 description: Number of EI types
897 description: Number of EI jobs
901 description: status text
902 producer_ei_type_info:
909 description: Json schema for the job data
910 description: Information for an EI type
911 producer_registration_info:
913 - ei_job_callback_url
914 - ei_producer_supervision_callback_url
920 description: Supported EI type IDs
923 description: Supported EI type IDs
924 ei_producer_supervision_callback_url:
926 description: callback for producer supervision
929 description: callback for EI job
930 description: Information for an EI producer
936 description: A human-readable explanation specific to this occurrence of
938 example: EI job type not found
941 description: The HTTP status code generated by the origin server for this
942 occurrence of the problem.
945 description: A problem detail to carry details in a HTTP response according
954 description: Allowed values for EI job status
958 description: Status for an EI job
969 description: EI type Idenitifier of the EI job
972 description: The target URI of the EI data
975 description: Identity of the owner of the job
976 statusNotificationUri:
978 description: The target of EI job status notifications
981 description: EI type specific job data
982 description: Information for an Enrichment Information Job
990 description: Allowed values for EI job status
994 description: Status for an EI job
1002 description: Represents the operational states
1006 description: Status for an EI Producer
1009 description: 'Void/empty '
1020 description: The target URI of the subscribed information
1023 description: Information type Idenitifier of the subscription job
1026 description: Identity of the owner of the job
1027 statusNotificationUri:
1029 description: The target of Information subscription job status notifications
1032 description: Information type specific job data
1033 description: Information for an Enrichment Information Job
1036 - consumer_job_data_schema
1039 consumer_job_data_schema:
1041 description: Json schema for the job data
1042 description: Information for an Information type