1 # ============LICENSE_START=======================================================
2 # Copyright (C) 2023 Nordix Foundation
3 # ================================================================================
4 # Licensed under the Apache License, Version 2.0 (the "License");
5 # you may not use this file except in compliance with the License.
6 # You may obtain a copy of the License at
8 # http://www.apache.org/licenses/LICENSE-2.0
10 # Unless required by applicable law or agreed to in writing, software
11 # distributed under the License is distributed on an "AS IS" BASIS,
12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 # See the License for the specific language governing permissions and
14 # limitations under the License.
16 # SPDX-License-Identifier: Apache-2.0
17 # ============LICENSE_END=========================================================
20 title: "PDP-D Telemetry Services Documentation"
21 description: PDP-D Telemetry Services
22 version: Swagger Server
24 - url: http://{drools-ip}:9696/policy/pdp/engine
29 - name: pdp-d-telemetry
30 description: Drools PDP Telemetry Operations
31 - name: pdp-d-lifecycle
32 description: Drools PDP Lifecycle Operations
34 description: Drools PDP Legacy Operations
40 summary: Retrieves the json swagger documentation
41 description: Lifecycle Group
45 description: successful operation
49 $ref: '#/components/schemas/Response'
52 $ref: '#/components/schemas/Response'
54 description: resource not found
57 description: swagger.json file not found
63 summary: Retrieves the Lifecycle group
64 description: Lifecycle Group
68 description: successful operation
72 $ref: '#/components/schemas/Response'
75 $ref: '#/components/schemas/Response'
76 /lifecycle/group/{group}:
80 summary: Updates the Lifecycle group
81 description: Lifecycle Group
82 operationId: updateGroup
92 description: successful operation
96 $ref: '#/components/schemas/Response'
99 $ref: '#/components/schemas/Response'
100 /lifecycle/status/interval:
104 summary: Retrieves the Lifecycle Status Timer Interval in seconds
105 description: Lifecycle Status Timer Interval in seconds
106 operationId: updateStatusTimer
109 description: successful operation
113 $ref: '#/components/schemas/Response'
116 $ref: '#/components/schemas/Response'
117 /lifecycle/status/interval/{timeout}:
121 summary: Updates the Lifecycle Status Timer Interval in seconds
122 description: Lifecycle Status Timer Interval in seconds
123 operationId: statusTimer
134 description: successful operation
138 $ref: '#/components/schemas/Response'
141 $ref: '#/components/schemas/Response'
142 /lifecycle/policyTypes:
146 summary: List of supported policy types
147 description: Lifecycle Policy Types
148 operationId: policyTypes
151 description: successful operation
155 $ref: '#/components/schemas/Response'
158 $ref: '#/components/schemas/Response'
163 summary: List of policies
164 operationId: policies
167 description: successful operation
171 $ref: '#/components/schemas/Response'
174 $ref: '#/components/schemas/Response'
178 summary: Deploy a policy
179 operationId: deployTrackedPolicy
181 description: Tosca Policy
192 description: successful operation
196 $ref: '#/components/schemas/Response'
199 $ref: '#/components/schemas/Response'
200 x-codegen-request-body-name: body
201 /lifecycle/policyTypes/{policyType}/{policyTypeVersion}:
205 summary: Entities associated with a policy type
206 description: Lifecycle policy Types
207 operationId: policyType
211 description: Policy Type
215 - name: policyTypeVersion
217 description: Policy Type Version
223 description: successful operation
227 $ref: '#/components/schemas/Response'
230 $ref: '#/components/schemas/Response'
231 /lifecycle/policies/operations:
235 summary: Gets Policy Operations
236 operationId: policiesOperations
239 description: successful operation
243 $ref: '#/components/schemas/Response'
246 $ref: '#/components/schemas/Response'
247 /lifecycle/policies/operations/deployment:
251 summary: Deploys a policy
252 description: Deploys a policy
253 operationId: deployOperation
255 description: Tosca Policy
266 description: successful operation
270 $ref: '#/components/schemas/Response'
273 $ref: '#/components/schemas/Response'
274 x-codegen-request-body-name: body
275 /lifecycle/policies/operations/undeployment:
279 summary: Undeploys a policy
280 operationId: undeployOperation
282 description: Tosca Policy
293 description: successful operation
297 $ref: '#/components/schemas/Response'
300 $ref: '#/components/schemas/Response'
301 x-codegen-request-body-name: body
302 /lifecycle/policies/operations/validation:
306 summary: Validates a policy
307 operationId: validateOperation
309 description: Tosca Policy
320 description: successful operation
324 $ref: '#/components/schemas/Response'
327 $ref: '#/components/schemas/Response'
328 x-codegen-request-body-name: body
329 /lifecycle/policies/{policyName}/{policyVersion}:
333 summary: Retrieves a policy
338 description: Policy Name
342 - name: policyVersion
344 description: Policy Version
350 description: successful operation
354 $ref: '#/components/schemas/Response'
357 $ref: '#/components/schemas/Response'
361 summary: Deletes a Lifecycle tracked policy
362 operationId: undeployPolicy
370 - name: policyVersion
372 description: Policy Version
378 description: successful operation
382 $ref: '#/components/schemas/Response'
385 $ref: '#/components/schemas/Response'
390 summary: Retrieves the Lifecycle state
391 description: Lifecycle State
395 description: successful operation
399 $ref: '#/components/schemas/Response'
402 $ref: '#/components/schemas/Response'
403 /lifecycle/state/{state}:
407 summary: updates the Lifecycle state
408 description: Lifecycle State
409 operationId: updateState
419 description: successful operation
423 $ref: '#/components/schemas/Response'
426 $ref: '#/components/schemas/Response'
427 /lifecycle/subgroup/{subgroup}:
431 summary: Retrieves the Lifecycle subgroup
432 description: Lifecycle Subgroup
433 operationId: subgroup
437 description: Subgroup
443 description: successful operation
447 $ref: '#/components/schemas/Response'
450 $ref: '#/components/schemas/Response'
455 summary: Retrieves the Lifecycle subgroup
456 description: Lifecycle Subgroup
457 operationId: subgroup_1
460 description: successful operation
464 $ref: '#/components/schemas/Response'
467 $ref: '#/components/schemas/Response'
468 /lifecycle/statistics:
472 summary: Gets Policy Statistics
476 description: successful operation
480 $ref: '#/components/schemas/Response'
483 $ref: '#/components/schemas/Response'
484 /lifecycle/properties:
488 summary: Retrieves the Lifecycle properties
489 description: Lifecycle Properties
490 operationId: propertiesLifecycle
493 description: successful operation
497 $ref: '#/components/schemas/Response'
500 $ref: '#/components/schemas/Response'
501 /lifecycle/topic/sink:
505 summary: Retrieves the Lifecycle topic sink
506 description: Lifecycle Topic Sink
510 description: successful operation
514 $ref: '#/components/schemas/Response'
517 $ref: '#/components/schemas/Response'
518 /lifecycle/topic/source:
522 summary: Retrieves the Lifecycle topic source
523 description: Lifecycle Topic Source
524 operationId: sourceLifecycle
527 description: successful operation
531 $ref: '#/components/schemas/Response'
534 $ref: '#/components/schemas/Response'
539 summary: Retrieves the Engine Operational Status
540 description: Top-level abstraction. Provides a global view of resources
544 description: successful operation
548 $ref: '#/components/schemas/Response'
551 $ref: '#/components/schemas/Response'
555 summary: Shuts down the Engine
556 description: Deleting the engine, the top-level abstraction, equivalenty shuts
558 operationId: engineShutdown
561 description: successful operation
565 $ref: '#/components/schemas/Response'
568 $ref: '#/components/schemas/Response'
573 summary: Engine Features
574 description: Provides the list of loaded features using the PolicyEngineFeatureAPI
575 operationId: engineFeatures
578 description: successful operation
582 $ref: '#/components/schemas/Response'
585 $ref: '#/components/schemas/Response'
586 /features/{featureName}:
590 summary: Engine Feature
591 description: Provides Details for a given feature Engine Provider
592 operationId: engineFeature
596 description: Feature Name
602 description: successful operation
606 $ref: '#/components/schemas/Response'
609 $ref: '#/components/schemas/Response'
611 description: The feature cannot be found
617 summary: Engine Detailed Feature Inventory
618 description: Provides detailed list of loaded features using the PolicyEngineFeatureAPI
619 operationId: engineFeaturesInventory
622 description: successful operation
626 $ref: '#/components/schemas/Response'
629 $ref: '#/components/schemas/Response'
634 summary: Engine Input Ports
635 description: List of input ports
636 operationId: engineInputs
639 description: successful operation
643 $ref: '#/components/schemas/Response'
646 $ref: '#/components/schemas/Response'
647 /inputs/configuration:
651 summary: Engine Input Configuration Requests
652 description: Feeds a configuration request input into the Engine
653 operationId: engineUpdate
655 description: Configuration to apply
659 $ref: '#/components/schemas/PdpdConfiguration'
662 $ref: '#/components/schemas/PdpdConfiguration'
666 description: successful operation
670 $ref: '#/components/schemas/Response'
673 $ref: '#/components/schemas/Response'
675 description: The configuration request cannot be honored
677 x-codegen-request-body-name: body
678 /environment/{envProperty}:
682 summary: Gets an environment variable
683 operationId: engineEnvironmentProperty
687 description: Environment Property
693 description: successful operation
697 $ref: '#/components/schemas/Response'
700 $ref: '#/components/schemas/Response'
704 summary: Adds a new environment value to the engine
705 operationId: engineEnvironmentAdd
709 description: Environment Property
714 description: Environment Value
722 description: successful operation
726 $ref: '#/components/schemas/Response'
729 $ref: '#/components/schemas/Response'
730 x-codegen-request-body-name: body
735 summary: Engine Environment Properties
736 description: Installation and OS environment properties used by the engine
737 operationId: engineEnvironment
740 description: successful operation
744 $ref: '#/components/schemas/Response'
747 $ref: '#/components/schemas/Response'
752 summary: Engine Control Switches
753 description: List of the Engine Control Switches
754 operationId: engineSwitches
757 description: successful operation
761 $ref: '#/components/schemas/Response'
764 $ref: '#/components/schemas/Response'
765 /switches/activation:
769 summary: Switches on the Engine Activation Switch
770 description: Turns on Activation Switch on the Engine. This order entails that
771 the engine and controllers are unlocked and started
772 operationId: engineActivation
775 description: successful operation
779 $ref: '#/components/schemas/Response'
782 $ref: '#/components/schemas/Response'
786 summary: Switches off Engine Activation Switch
787 description: Turns off the Activation Switch on the Engine. This order entails
788 that the engine and controllers are locked (with the exception of those resources
789 defined as unmanaged)
790 operationId: engineDeactivation
793 description: successful operation
797 $ref: '#/components/schemas/Response'
800 $ref: '#/components/schemas/Response'
805 summary: Switches on the Engine Lock Control
806 description: This switch locks all the engine resources as a whole, except those
807 that are defined unmanaged
808 operationId: engineLock
811 description: successful operation
815 $ref: '#/components/schemas/Response'
818 $ref: '#/components/schemas/Response'
820 description: The system is an administrative state that prevents this request
826 summary: Switches off the Lock control
827 description: This switch locks all the engine resources as a whole, except those
828 that are defined unmanaged
829 operationId: engineUnlock
832 description: successful operation
836 $ref: '#/components/schemas/Response'
839 $ref: '#/components/schemas/Response'
841 description: The system is an administrative state that prevents this request
848 summary: Engine Configuration Properties
849 description: Used for booststrapping the engine
850 operationId: engineProperties
853 description: successful operation
857 $ref: '#/components/schemas/Response'
860 $ref: '#/components/schemas/Response'
865 summary: Lists the Policy Controllers Names
866 description: Unique Policy Controller Identifiers
867 operationId: controllers
870 description: successful operation
874 $ref: '#/components/schemas/Response'
877 $ref: '#/components/schemas/Response'
881 summary: Creates and starts a new Policy Controller
882 description: Controller creation based on properties
883 operationId: controllerAdd
885 description: Configuration Properties to apply
889 $ref: '#/components/schemas/Properties'
892 $ref: '#/components/schemas/Properties'
896 description: successful operation
900 $ref: '#/components/schemas/Response'
903 $ref: '#/components/schemas/Response'
905 description: The controller has been succesfully created and started
908 description: The controller has been created but cannot be started
911 description: The controller already exists
914 description: Invalid configuration information has been provided
917 description: The administrative state of the system prevents it from processing
920 x-codegen-request-body-name: body
921 /controllers/features:
925 summary: Lists of Feature Providers Identifiers
926 description: Unique Policy Controller Identifiers
927 operationId: controllerFeatures
930 description: successful operation
934 $ref: '#/components/schemas/Response'
937 $ref: '#/components/schemas/Response'
938 /controllers/features/{featureName}:
942 summary: Controller Feature
943 description: Provides Details for a given Policy Controller feature provider
944 operationId: controllerFeature
948 description: Feature Name
954 description: successful operation
958 $ref: '#/components/schemas/Response'
961 $ref: '#/components/schemas/Response'
963 description: The feature cannot be found
965 /controllers/inventory:
969 summary: Lists the Policy Controllers
970 description: Detailed list of Policy Controllers
971 operationId: controllerInventory
974 description: successful operation
978 $ref: '#/components/schemas/Response'
981 $ref: '#/components/schemas/Response'
982 /controllers/features/inventory:
986 summary: Detailed Controllers Feature Inventory
987 description: Provides detailed list of loaded features using the PolicyControllerFeatureAPI
988 operationId: controllerFeaturesInventory
991 description: successful operation
995 $ref: '#/components/schemas/Response'
998 $ref: '#/components/schemas/Response'
999 /controllers/{controller}:
1003 summary: Retrieves a Policy Controller
1004 description: A Policy Controller is a concrete drools application abstraction. It
1005 aggregates networking, drools, and other resources,as provides operational
1006 controls over drools applications
1007 operationId: controller
1011 description: Policy Controller Name
1017 description: successful operation
1021 $ref: '#/components/schemas/Response'
1024 $ref: '#/components/schemas/Response'
1026 description: The controller cannot be found
1029 description: The system is an administrative state that prevents this request
1035 summary: Deletes a Policy Controller
1036 description: A Policy Controller is a concrete drools application abstraction. It
1037 aggregates networking, drools, and other resources,as provides operational
1038 controls over drools applications
1039 operationId: controllerDelete
1043 description: Policy Controller Name
1049 description: successful operation
1053 $ref: '#/components/schemas/Response'
1056 $ref: '#/components/schemas/Response'
1058 description: The controller cannot be found
1061 description: The system is an administrative state that prevents this request
1065 description: A problem has occurred while deleting the Policy Controller
1067 /controllers/{controller}/inputs:
1071 summary: Policy Controller Input Ports
1072 description: List of input ports
1073 operationId: controllerInputs
1077 description: Policy Controller Name
1083 description: successful operation
1087 $ref: '#/components/schemas/Response'
1090 $ref: '#/components/schemas/Response'
1091 /controllers/{controller}/inputs/configuration:
1095 summary: Policy Controller Input Configuration Requests
1096 description: Feeds a configuration request input into the given Policy Controller
1097 operationId: controllerUpdate
1101 description: Policy Controller Name
1106 description: Configuration to apply
1110 $ref: '#/components/schemas/ControllerConfiguration'
1113 $ref: '#/components/schemas/ControllerConfiguration'
1117 description: successful operation
1121 $ref: '#/components/schemas/Response'
1124 $ref: '#/components/schemas/Response'
1126 description: The configuration request is invalid
1129 description: The configuration request cannot be honored
1131 x-codegen-request-body-name: body
1132 /controllers/{controller}/switches:
1136 summary: Policy Controller Switches
1137 description: List of the Policy Controller Switches
1138 operationId: controllerSwitches
1142 description: Policy Controller Name
1148 description: successful operation
1152 $ref: '#/components/schemas/Response'
1155 $ref: '#/components/schemas/Response'
1156 /controllers/{controller}/switches/lock:
1160 summary: Switches on the Policy Controller Lock Control
1161 description: This action on the switch locks the Policy Controller
1162 operationId: controllerLock
1166 description: Policy Controller Name
1172 description: successful operation
1176 $ref: '#/components/schemas/Response'
1179 $ref: '#/components/schemas/Response'
1181 description: The system is an administrative state that prevents this request
1187 summary: Switches off the Policy Controller Lock Control
1188 description: This action on the switch unlocks the Policy Controller
1189 operationId: controllerUnlock
1193 description: Policy Controller Name
1199 description: successful operation
1203 $ref: '#/components/schemas/Response'
1206 $ref: '#/components/schemas/Response'
1208 description: The system is an administrative state that prevents this request
1211 /controllers/{controller}/drools/facts/{session}/{factType}:
1215 summary: Retrieves fact objects of a given type in the drools working memoryfor
1216 a given controller and session
1217 description: The fact types are the classnames of the objects inserted in the
1218 drools working memory
1219 operationId: droolsFacts
1223 description: Fact count
1229 description: Policy Controller Name
1235 description: Drools Session Name
1241 description: Drools Fact Type
1247 description: successful operation
1251 $ref: '#/components/schemas/Response'
1254 $ref: '#/components/schemas/Response'
1256 description: The controller, session, or fact type cannot be found
1259 description: The system is an administrative state that prevents this request
1265 summary: Deletes all the fact objects of a given type from the drools working
1266 memoryfor a given controller and session. The objects retracted from the
1267 working memory are provided in the response.
1268 description: The fact types are the classnames of the objects inserted in the
1269 drools working memory
1270 operationId: droolsFactsDelete_1
1274 description: Policy Controller Name
1280 description: Drools Session Name
1286 description: Drools Fact Type
1292 description: successful operation
1296 $ref: '#/components/schemas/Response'
1299 $ref: '#/components/schemas/Response'
1301 description: The controller, session, or fact type, cannot be found
1304 description: The system is an administrative state that prevents this request
1308 description: A server error has occurred processing this request
1310 /controllers/{controller}/drools/facts/{session}:
1314 summary: Retrieves Fact Types (classnames) for a given controller and its count
1315 description: The fact types are the classnames of the objects inserted in the
1316 drools working memory
1317 operationId: droolsFacts_1
1321 description: Policy Controller Name
1327 description: Drools Session Name
1333 description: successful operation
1337 $ref: '#/components/schemas/Response'
1340 $ref: '#/components/schemas/Response'
1342 description: The controller or session cannot be found
1345 description: The system is an administrative state that prevents this request
1348 /controllers/{controller}/drools/facts:
1352 summary: Retrieves Facts Summary information for a given controller
1353 description: Provides the session names, and a count of fact object in the drools
1355 operationId: droolsFacts_2
1359 description: Policy Controller Name
1365 description: successful operation
1369 $ref: '#/components/schemas/Response'
1372 $ref: '#/components/schemas/Response'
1374 description: The controller cannot be found
1377 description: The system is an administrative state that prevents this request
1380 /controllers/{controller}/drools/facts/{session}/{query}/{queriedEntity}:
1384 summary: Gets all the fact objects returned by a DRL query with no parameters
1385 from the drools working memoryfor a given controller and session
1386 description: The DRL query must be defined in the DRL file
1387 operationId: droolsFacts_3
1391 description: Fact count
1397 description: Policy Controller Name
1403 description: Drools Session Name
1409 description: Query Name Present in DRL
1413 - name: queriedEntity
1415 description: Query Identifier Present in the DRL Query
1421 description: successful operation
1425 $ref: '#/components/schemas/Response'
1428 $ref: '#/components/schemas/Response'
1430 description: The controller, session, or query information, cannot be found
1433 description: The system is an administrative state that prevents this request
1437 description: A server error has occurred processing this request
1442 summary: Gets all the fact objects returned by a DRL query with parameters from
1443 the drools working memoryfor a given controller and session
1444 description: The DRL query with parameters must be defined in the DRL file
1445 operationId: droolsFacts_4
1449 description: Policy Controller Name
1455 description: Drools Session Name
1461 description: Query Name Present in DRL
1465 - name: queriedEntity
1467 description: Query Identifier Present in the DRL Query
1472 description: Query Parameter Values to pass in the DRL Query
1489 description: successful operation
1493 $ref: '#/components/schemas/Response'
1496 $ref: '#/components/schemas/Response'
1498 description: The controller, session, or query information, cannot be found
1501 description: The system is an administrative state that prevents this request
1505 description: A server error has occurred processing this request
1507 x-codegen-request-body-name: body
1511 summary: Deletes all the fact objects returned by a DRL query with parameters
1512 from the drools working memory for a given controller and session
1513 description: The DRL query with parameters must be defined in the DRL file
1514 operationId: droolsFactsDelete
1518 description: Policy Controller Name
1524 description: Drools Session Name
1530 description: Query Name Present in DRL
1534 - name: queriedEntity
1536 description: Query Identifier Present in the DRL Query
1542 description: successful operation
1546 $ref: '#/components/schemas/Response'
1549 $ref: '#/components/schemas/Response'
1551 description: The controller, session, or query information, cannot be found
1554 description: The system is an administrative state that prevents this request
1558 description: A server error has occurred processing this request
1560 x-codegen-request-body-name: body
1561 /controllers/{controller}/decoders:
1565 summary: Gets all the decoders used by a controller
1566 description: A Policy Controller uses decoders to deserialize incoming network
1567 messages from subscribed network topics into specific (fact) objects. The
1568 deserialized (fact) object will typically be inserted in the drools working memory
1569 of the controlled drools application.
1570 operationId: decoders
1574 description: Policy Controller Name
1580 description: successful operation
1584 $ref: '#/components/schemas/Response'
1587 $ref: '#/components/schemas/Response'
1589 description: The controller cannot be found
1592 description: The system is an administrative state that prevents this request
1595 /controllers/{controller}/decoders/filters:
1599 summary: Gets all the filters used by a controller
1600 description: A Policy Controller uses decoders to deserialize incoming network
1601 messages from subscribed network topics into specific (fact) objects. The
1602 deserialized (fact) object will typically be inserted in the drools working memory
1603 of the controlled drools application.Acceptance filters are used to filter
1604 out undesired network messages for the given controller
1605 operationId: decoderFilters
1609 description: Policy Controller Name
1615 description: successful operation
1619 $ref: '#/components/schemas/Response'
1622 $ref: '#/components/schemas/Response'
1624 description: The controller cannot be found
1627 description: The system is an administrative state that prevents this request
1630 /controllers/{controller}/decoders/{topic}:
1634 summary: Gets all the decoders in use by a controller for a networked topic
1635 description: A Policy Controller uses decoders to deserialize incoming network
1636 messages from subscribed network topics into specific (fact) objects. The
1637 deserialized (fact) object will typically be inserted in the drools working memory
1638 of the controlled drools application.
1639 operationId: decoder
1643 description: Policy Controller Name
1649 description: Networked Topic Name
1655 description: successful operation
1659 $ref: '#/components/schemas/Response'
1662 $ref: '#/components/schemas/Response'
1664 description: The controller or topic cannot be found
1667 description: The system is an administrative state that prevents this request
1673 summary: Decodes a string into a fact object, and encodes it back into a string
1674 description: Tests the decode/encode functions of a controller
1679 description: Policy Controller Name
1685 description: Topic Name
1690 description: JSON String to decode
1698 description: successful operation
1702 $ref: '#/components/schemas/Response'
1705 $ref: '#/components/schemas/Response'
1707 description: Bad input has been provided
1710 description: The controller cannot be found
1713 description: The system is an administrative state that prevents this request
1716 x-codegen-request-body-name: body
1717 /controllers/{controller}/decoders/{topic}/filters/{factType}:
1721 summary: Gets all filters attached to decoders for a given subscribed networked
1723 description: Decoders are associated with networked topics. A Policy Controller
1724 manages multiple topics and therefore its attached decoders. A Policy Controller
1725 uses filters to further specify the fact mapping. Filters are applied on
1726 a per fact type (classname).
1727 operationId: decoderFilter_1
1731 description: Policy Controller Name
1737 description: Networked Topic Name
1743 description: Fact Type
1749 description: successful operation
1753 $ref: '#/components/schemas/Response'
1756 $ref: '#/components/schemas/Response'
1758 description: The controller, topic, or fact type cannot be found
1761 description: The system is an administrative state that prevents this request
1767 summary: Attaches filters to the decoder for a given networked topic and fact
1769 description: Decoders are associated with networked topics. A Policy Controller
1770 manages multiple topics and therefore its attached decoders. A Policy Controller
1771 uses filters to further specify the fact mapping. Filters are applied on
1772 a per fact type (classname).
1773 operationId: decoderFilter
1777 description: Policy Controller Name
1783 description: Topic Name
1789 description: Fact Type
1794 description: Configuration Filter
1798 $ref: '#/components/schemas/JsonProtocolFilter'
1801 $ref: '#/components/schemas/JsonProtocolFilter'
1805 description: successful operation
1809 $ref: '#/components/schemas/Response'
1812 $ref: '#/components/schemas/Response'
1814 description: The controller, topic, fact type, cannot be found, or a filter
1815 has not been provided
1818 description: The system is an administrative state that prevents this request
1821 x-codegen-request-body-name: body
1822 /controllers/{controller}/decoders/{topic}/filters:
1826 summary: Gets all filters attached to decoders for a given networked topic in
1828 description: A Policy Controller uses decoders to deserialize incoming network
1829 messages from subscribed network topics into specific (fact) objects. The
1830 deserialized (fact) object will typically be inserted in the drools working memory
1831 of the controlled drools application.Acceptance filters are used to filter
1832 out undesired network messages for the given controller
1833 operationId: decoderFilter_2
1837 description: Policy Controller Name
1843 description: Networked Topic Name
1849 description: successful operation
1853 $ref: '#/components/schemas/Response'
1856 $ref: '#/components/schemas/Response'
1858 description: The controller or topic cannot be found
1861 description: The system is an administrative state that prevents this request
1864 /controllers/{controller}/decoders/{topic}/filters/{factType}/rule:
1868 summary: Gets the filter rule attached to a topic decoder of a controller
1869 description: 'Decoders are associated with networked topics. A Policy Controller
1870 manages multiple topics and therefore its attached decoders. A Policy Controller
1871 uses filters to further specify the fact mapping. Filters are applied on
1872 a per fact type using a jsonpath expression rule. '
1873 operationId: decoderFilterRules
1877 description: Policy Controller Name
1883 description: Topic Name
1889 description: Fact Type
1895 description: successful operation
1899 $ref: '#/components/schemas/Response'
1902 $ref: '#/components/schemas/Response'
1904 description: The controller, topic, or fact type cannot be found
1907 description: The system is an administrative state that prevents this request
1913 summary: Places a new filter rule in a topic decoder
1914 description: 'Decoders are associated with networked topics. A Policy Controller
1915 manages multiple topics and therefore its attached decoders. A Policy Controller
1916 uses filters to further specify the fact mapping. Filters are applied on
1917 a per fact type using a jsonpath expression rule. '
1918 operationId: decoderFilterRule
1922 description: Policy Controller Name
1928 description: Topic Name
1934 description: Fact Type
1939 description: JsonPath filter expression
1950 description: successful operation
1954 $ref: '#/components/schemas/Response'
1957 $ref: '#/components/schemas/Response'
1959 description: The controller, topic, or fact type cannot be found
1962 description: The system is an administrative state that prevents this request
1965 x-codegen-request-body-name: body
1969 summary: Deletes the filter rule attached to a topic decoder of a controller
1970 description: 'Decoders are associated with networked topics. A Policy Controller
1971 manages multiple topics and therefore its attached decoders. A Policy Controller
1972 uses filters to further specify the fact mapping. Filters are applied on
1973 a per fact type using a jsonpath expression rule. '
1974 operationId: decoderFilterRuleDelete
1978 description: Policy Controller Name
1984 description: Topic Name
1990 description: Fact Type
1996 description: successful operation
2000 $ref: '#/components/schemas/Response'
2003 $ref: '#/components/schemas/Response'
2005 description: The controller, topic, or fact type cannot be found
2008 description: The system is an administrative state that prevents this request
2011 /controllers/{controller}/encoders:
2015 summary: Retrieves the encoder filters of a controller
2016 description: The encoders serializes a fact object, typically for network transmission
2017 operationId: encoderFilters
2021 description: Policy Controller Name
2027 description: successful operation
2031 $ref: '#/components/schemas/Response'
2034 $ref: '#/components/schemas/Response'
2036 description: Bad input has been provided
2039 description: The system is an administrative state that prevents this request
2042 /controllers/{controller}/drools:
2046 summary: Retrieves the Drools Controller subcomponent of the Policy Controller
2047 description: The Drools Controller provides an abstraction over the Drools subsystem
2052 description: Policy Controller Name
2058 description: successful operation
2062 $ref: '#/components/schemas/Response'
2065 $ref: '#/components/schemas/Response'
2067 description: The controller cannot be found
2070 description: The system is an administrative state that prevents this request
2073 /controllers/{controller}/properties:
2077 summary: Retrieves the configuration properties of a Policy Controller
2078 description: Configuration resources used by the controller if Properties format
2079 operationId: controllerProperties
2083 description: Policy Controller Name
2089 description: successful operation
2093 $ref: '#/components/schemas/Response'
2096 $ref: '#/components/schemas/Response'
2098 description: The controller cannot be found
2101 description: The system is an administrative state that prevents this request
2104 /controllers/tools/coders/decoders/filters/rule:
2108 summary: Produces a Decoder Rule Filter in a format that the Policy Controller
2110 description: The result can be used with other APIs to attach a filter to a
2114 description: JsonPath expression
2125 description: successful operation
2129 $ref: '#/components/schemas/Response'
2132 $ref: '#/components/schemas/Response'
2133 x-codegen-request-body-name: body
2138 summary: Produces an UUID
2139 description: UUID generation utility
2143 description: successful operation
2147 $ref: '#/components/schemas/Response'
2150 $ref: '#/components/schemas/Response'
2151 /tools/loggers/{logger}/{level}:
2155 summary: sets the logger level
2156 description: Please use the SLF4J logger levels
2157 operationId: loggerName
2161 description: Logger Name
2167 description: Logger Level
2173 description: successful operation
2177 $ref: '#/components/schemas/Response'
2180 $ref: '#/components/schemas/Response'
2182 description: logger not found
2185 description: logging misconfiguration
2187 /tools/loggers/{logger}:
2191 summary: logging level of a logger
2192 operationId: loggerName_1
2196 description: Logger Name
2202 description: successful operation
2206 $ref: '#/components/schemas/Response'
2209 $ref: '#/components/schemas/Response'
2211 description: logger not found
2214 description: logging misconfiguration
2220 summary: all active loggers
2221 operationId: loggers
2224 description: successful operation
2228 $ref: '#/components/schemas/Response'
2231 $ref: '#/components/schemas/Response'
2233 description: logging misconfiguration
2239 summary: Retrieves the managed topics
2240 description: Network Topics Aggregation
2244 description: successful operation
2248 $ref: '#/components/schemas/Response'
2251 $ref: '#/components/schemas/Response'
2256 summary: Retrieves the managed topic sources
2257 description: Network Topic Sources Agregation
2258 operationId: sources
2261 description: successful operation
2265 $ref: '#/components/schemas/Response'
2268 $ref: '#/components/schemas/Response'
2273 summary: Retrieves the managed topic sinks
2274 description: Network Topic Sinks Agregation
2278 description: successful operation
2282 $ref: '#/components/schemas/Response'
2285 $ref: '#/components/schemas/Response'
2290 summary: Topics Control Switches
2291 description: List of the Topic Control Switches
2292 operationId: topicSwitches
2295 description: successful operation
2299 $ref: '#/components/schemas/Response'
2302 $ref: '#/components/schemas/Response'
2303 /topics/switches/lock:
2307 summary: Locks all the managed topics
2308 description: The operation affects all managed sources and sinks
2309 operationId: topicsLock
2312 description: successful operation
2316 $ref: '#/components/schemas/Response'
2319 $ref: '#/components/schemas/Response'
2321 description: The system is an administrative state that prevents this request
2327 summary: Unlocks all the managed topics
2328 description: The operation affects all managed sources and sinks
2329 operationId: topicsUnlock
2332 description: successful operation
2336 $ref: '#/components/schemas/Response'
2339 $ref: '#/components/schemas/Response'
2341 description: The system is an administrative state that prevents this request
2344 /topics/sources/{comm}:
2348 summary: Retrieves managed topic sources
2349 description: Sources for a communication infrastructure
2350 operationId: commSources
2354 description: Communication Mechanism
2357 pattern: ueb|dmaap|noop
2361 description: successful operation
2365 $ref: '#/components/schemas/Response'
2368 $ref: '#/components/schemas/Response'
2369 /topics/sinks/{comm}:
2373 summary: Retrieves managed topic sinks
2374 description: Communication Infrastructure Sinks
2375 operationId: commSinks
2379 description: Communication Mechanism
2382 pattern: ueb|dmaap|noop
2386 description: successful operation
2390 $ref: '#/components/schemas/Response'
2393 $ref: '#/components/schemas/Response'
2394 /topics/sources/{comm}/{topic}:
2398 summary: Retrieves a managed topic source
2399 description: This is an Network Communication Endpoint source of messages for
2401 operationId: sourceTopic
2405 description: Communication Mechanism
2408 pattern: ueb|dmaap|noop
2412 description: Topic Name
2418 description: successful operation
2422 $ref: '#/components/schemas/Response'
2425 $ref: '#/components/schemas/Response'
2426 /topics/sinks/{comm}/{topic}:
2430 summary: Retrieves a managed topic sink
2431 description: This is a Network Communicaton Endpoint destination of messages
2433 operationId: sinkTopic
2437 description: Communication Mechanism
2440 pattern: ueb|dmaap|noop
2444 description: Topic Name
2450 description: successful operation
2454 $ref: '#/components/schemas/Response'
2457 $ref: '#/components/schemas/Response'
2458 /topics/sources/{comm}/{topic}/events:
2462 summary: Retrieves the latest events received by an UEB topic
2463 description: This is a Network Communicaton Endpoint source of messages for
2465 operationId: sourceEvents
2469 description: Communication Mechanism
2472 pattern: ueb|dmaap|noop
2476 description: Topic Name
2482 description: successful operation
2486 $ref: '#/components/schemas/Response'
2489 $ref: '#/components/schemas/Response'
2493 summary: Offers an event to a topic for internal processing by the engine
2494 description: The offered event is treated as it was incoming from the network
2495 operationId: commEventOffer
2499 description: Communication Mechanism
2502 pattern: ueb|dmaap|noop
2506 description: Topic Name
2511 description: Network Message
2519 description: successful operation
2523 $ref: '#/components/schemas/Response'
2526 $ref: '#/components/schemas/Response'
2528 description: The topic information cannot be found
2531 description: The system is an administrative state that prevents this request
2535 description: A server error has occurred processing this request
2537 x-codegen-request-body-name: body
2538 /topics/sinks/{comm}/{topic}/events:
2542 summary: Retrieves the latest events received by an UEB topic
2543 description: This is a Network Communicaton Endpoint source of messages for
2545 operationId: sinkEvents
2549 description: Communication Mechanism
2552 pattern: ueb|dmaap|noop
2556 description: Topic Name
2562 description: successful operation
2566 $ref: '#/components/schemas/Response'
2569 $ref: '#/components/schemas/Response'
2570 /topics/sinks/{comm}/{topic}/switches/lock:
2574 summary: Locks a topic sink
2575 operationId: commSinkTopicLock
2579 description: Communication Mechanism
2582 pattern: ueb|dmaap|noop
2586 description: Topic Name
2592 description: successful operation
2596 $ref: '#/components/schemas/Response'
2599 $ref: '#/components/schemas/Response'
2601 description: The system is an administrative state that prevents this request
2607 summary: Unlocks a topic sink
2608 operationId: commSinkTopicUnlock
2612 description: Communication Mechanism
2615 pattern: ueb|dmaap|noop
2619 description: Topic Name
2625 description: successful operation
2629 $ref: '#/components/schemas/Response'
2632 $ref: '#/components/schemas/Response'
2634 description: The system is an administrative state that prevents this request
2637 /topics/sources/{comm}/{topic}/switches:
2641 summary: Topic Control Switches
2642 description: List of the Topic Control Switches
2643 operationId: commSourceTopicSwitches
2647 description: Communication Mechanism
2650 pattern: ueb|dmaap|noop
2654 description: Topic Name
2660 description: successful operation
2664 $ref: '#/components/schemas/Response'
2667 $ref: '#/components/schemas/Response'
2668 /topics/sinks/{comm}/{topic}/switches:
2672 summary: Topic Control Switches
2673 description: List of the Topic Control Switches
2674 operationId: commSinkTopicSwitches
2678 description: Communication Mechanism
2681 pattern: ueb|dmaap|noop
2685 description: Topic Name
2691 description: successful operation
2695 $ref: '#/components/schemas/Response'
2698 $ref: '#/components/schemas/Response'
2699 /topics/sources/{comm}/{topic}/switches/lock:
2703 summary: Locks a topic
2704 operationId: commSourceTopicLock
2708 description: Communication Mechanism
2711 pattern: ueb|dmaap|noop
2715 description: Topic Name
2721 description: successful operation
2725 $ref: '#/components/schemas/Response'
2728 $ref: '#/components/schemas/Response'
2730 description: The system is an administrative state that prevents this request
2736 summary: Unlocks topic
2737 operationId: commSourceTopicUnlock
2741 description: Communication Mechanism
2744 pattern: ueb|dmaap|noop
2748 description: Topic Name
2754 description: successful operation
2758 $ref: '#/components/schemas/Response'
2761 $ref: '#/components/schemas/Response'
2763 description: The system is an administrative state that prevents this request
2766 /topics/sources/{comm}/{topic}/switches/activation:
2770 summary: Starts a topic
2771 operationId: commSourceTopicActivation
2775 description: Communication Mechanism
2778 pattern: ueb|dmaap|noop
2782 description: Topic Name
2788 description: successful operation
2792 $ref: '#/components/schemas/Response'
2795 $ref: '#/components/schemas/Response'
2797 description: The system is an administrative state that prevents this request
2803 summary: Stops a topic
2804 operationId: commSourceTopicDeactivation
2808 description: Communication Mechanism
2811 pattern: ueb|dmaap|noop
2815 description: Topic Name
2821 description: successful operation
2825 $ref: '#/components/schemas/Response'
2828 $ref: '#/components/schemas/Response'
2830 description: The system is an administrative state that prevents this request
2833 /topics/sinks/{comm}/{topic}/switches/activation:
2837 summary: Starts a topic sink
2838 operationId: commSinkTopicActivation
2842 description: Communication Mechanism
2845 pattern: ueb|dmaap|noop
2849 description: Topic Name
2855 description: successful operation
2859 $ref: '#/components/schemas/Response'
2862 $ref: '#/components/schemas/Response'
2864 description: The system is an administrative state that prevents this request
2870 summary: Stops a topic
2871 operationId: commSinkTopicDeactivation
2875 description: Communication Mechanism
2878 pattern: ueb|dmaap|noop
2882 description: Topic Name
2888 description: successful operation
2892 $ref: '#/components/schemas/Response'
2895 $ref: '#/components/schemas/Response'
2897 description: The system is an administrative state that prevents this request
2900 /legacy/config/properties:
2904 summary: Legacy Engine Configuration Properties
2905 description: Used for booststrapping the engine
2906 operationId: properties
2909 description: successful operation
2913 $ref: '#/components/schemas/Response'
2916 $ref: '#/components/schemas/Response'
2917 /legacy/config/topic/source:
2921 summary: Retrieves the legacy configuration topic source
2922 description: Legacy Topic Source
2926 description: successful operation
2930 $ref: '#/components/schemas/Response'
2933 $ref: '#/components/schemas/Response'
2951 topicCommInfrastructure:
2963 PolicyTypeController:
2967 $ref: '#/components/schemas/ToscaConceptIdentifier'
2968 ToscaConceptIdentifier:
2975 PdpEngineWorkerStatistics:
2997 averageExecutionTime:
3024 policyExecutedCount:
3027 policyExecutedSuccessCount:
3030 policyExecutedFailCount:
3036 policyDeploySuccessCount:
3039 policyDeployFailCount:
3042 policyUndeployCount:
3045 policyUndeploySuccessCount:
3048 policyUndeployFailCount:
3054 $ref: '#/components/schemas/PdpEngineWorkerStatistics'
3070 topicCommInfrastructure:
3100 additionalProperties:
3111 additionalProperties:
3115 $ref: '#/components/schemas/ToscaConceptIdentifier'
3117 $ref: '#/components/schemas/ToscaConceptIdentifier'
3123 $ref: '#/components/schemas/ToscaEntityKey'
3126 AgendaEventListener:
3138 $ref: '#/components/schemas/ClassLoader'
3142 $ref: '#/components/schemas/Module'
3143 registeredAsParallelCapable:
3148 $ref: '#/components/schemas/Package'
3172 $ref: '#/components/schemas/PolicyContainer'
3179 canonicalSessionNames:
3202 $ref: '#/components/schemas/FactHandle'
3214 $ref: '#/components/schemas/Annotation'
3217 additionalProperties:
3234 additionalProperties:
3242 $ref: '#/components/schemas/Annotation'
3252 $ref: '#/components/schemas/FactField'
3289 $ref: '#/components/schemas/Process'
3293 $ref: '#/components/schemas/KieSession'
3302 $ref: '#/components/schemas/KiePackage'
3303 kieBaseEventListeners:
3306 $ref: '#/components/schemas/KieBaseEventListener'
3307 KieBaseEventListener:
3312 kieSessionConfiguration:
3313 $ref: '#/components/schemas/KieSessionConfiguration'
3315 $ref: '#/components/schemas/ReleaseId'
3317 $ref: '#/components/schemas/KieBase'
3323 $ref: '#/components/schemas/ClassLoader'
3330 $ref: '#/components/schemas/Process'
3334 $ref: '#/components/schemas/FactType'
3338 $ref: '#/components/schemas/Query'
3346 $ref: '#/components/schemas/Global'
3350 $ref: '#/components/schemas/Rule'
3365 $ref: '#/components/schemas/Globals'
3367 $ref: '#/components/schemas/KieBase'
3369 $ref: '#/components/schemas/SessionClock'
3370 sessionConfiguration:
3371 $ref: '#/components/schemas/KieSessionConfiguration'
3373 $ref: '#/components/schemas/Calendars'
3376 additionalProperties:
3377 $ref: '#/components/schemas/Channel'
3379 $ref: '#/components/schemas/Environment'
3381 $ref: '#/components/schemas/Agenda'
3385 $ref: '#/components/schemas/EntryPoint'
3396 $ref: '#/components/schemas/FactHandle'
3403 $ref: '#/components/schemas/ProcessInstance'
3405 $ref: '#/components/schemas/WorkItemManager'
3407 $ref: '#/components/schemas/KieRuntimeLogger'
3408 ruleRuntimeEventListeners:
3411 $ref: '#/components/schemas/RuleRuntimeEventListener'
3412 agendaEventListeners:
3415 $ref: '#/components/schemas/AgendaEventListener'
3416 processEventListeners:
3419 $ref: '#/components/schemas/ProcessEventListener'
3420 KieSessionConfiguration:
3426 $ref: '#/components/schemas/ModuleLayer'
3430 $ref: '#/components/schemas/ModuleDescriptor'
3432 $ref: '#/components/schemas/ClassLoader'
3436 $ref: '#/components/schemas/Annotation'
3437 declaredAnnotations:
3440 $ref: '#/components/schemas/Annotation'
3464 specificationVersion:
3466 specificationVendor:
3468 implementationTitle:
3470 implementationVersion:
3472 implementationVendor:
3477 $ref: '#/components/schemas/Annotation'
3478 declaredAnnotations:
3481 $ref: '#/components/schemas/Annotation'
3488 $ref: '#/components/schemas/KieContainer'
3492 $ref: '#/components/schemas/PolicySession'
3502 $ref: '#/components/schemas/ClassLoader'
3511 $ref: '#/components/schemas/TopicSource'
3515 $ref: '#/components/schemas/ToscaConceptIdentifier'
3519 $ref: '#/components/schemas/TopicSink'
3521 $ref: '#/components/schemas/DroolsController'
3526 additionalProperties:
3538 $ref: '#/components/schemas/HttpServletServer'
3542 $ref: '#/components/schemas/PolicyController'
3543 policyControllerIds:
3550 $ref: '#/components/schemas/PolicyEngineFeatureApi'
3556 $ref: '#/components/schemas/DomainMaker'
3558 $ref: '#/components/schemas/PolicyStatsManager'
3561 additionalProperties:
3570 $ref: '#/components/schemas/TopicSource'
3574 $ref: '#/components/schemas/TopicSink'
3576 $ref: '#/components/schemas/ScheduledExecutorService'
3579 additionalProperties:
3587 PolicyEngineFeatureApi:
3601 $ref: '#/components/schemas/PolicyContainer'
3603 $ref: '#/components/schemas/KieSession'
3609 policyExecutedCount:
3612 policyExecutedSuccessCount:
3615 policyExecutedFailCount:
3621 averageExecutionTime:
3637 $ref: '#/components/schemas/PolicyStats'
3640 additionalProperties:
3641 $ref: '#/components/schemas/PolicyStats'
3646 $ref: '#/components/schemas/Resource'
3649 additionalProperties:
3674 ProcessEventListener:
3679 parentProcessInstanceId:
3685 $ref: '#/components/schemas/Process'
3703 additionalProperties:
3741 $ref: '#/components/schemas/ResourceConfiguration'
3745 $ref: '#/components/schemas/ResourceType'
3749 $ref: '#/components/schemas/Reader'
3751 $ref: '#/components/schemas/InputStream'
3752 ResourceConfiguration:
3765 fullyCoveredByExecModel:
3776 additionalProperties:
3797 RuleRuntimeEventListener:
3799 ScheduledExecutorService:
3814 PolicyControllerFeatureApi:
3822 ControllerConfiguration:
3830 $ref: '#/components/schemas/DroolsConfiguration'
3831 additionalProperties:
3833 additionalProperties:
3836 DroolsConfiguration:
3845 additionalProperties:
3847 additionalProperties:
3856 $ref: '#/components/schemas/JsonProtocolFilter'
3857 modelClassLoaderHash:
3872 ProtocolCoderToolset:
3886 $ref: '#/components/schemas/CoderFilters'
3888 $ref: '#/components/schemas/CustomCoder'
3910 topicCommInfrastructure:
3951 topicCommInfrastructure:
3984 topicCommInfrastructure:
4025 topicCommInfrastructure:
4056 topicCommInfrastructure:
4083 topicCommInfrastructure:
4097 $ref: '#/components/schemas/UebTopicSource'
4101 $ref: '#/components/schemas/UebTopicSink'
4105 $ref: '#/components/schemas/DmaapTopicSink'
4109 $ref: '#/components/schemas/KafkaTopicSink'
4113 $ref: '#/components/schemas/NoopTopicSink'
4117 $ref: '#/components/schemas/DmaapTopicSource'
4121 $ref: '#/components/schemas/KafkaTopicSource'
4125 $ref: '#/components/schemas/NoopTopicSource'
4129 $ref: '#/components/schemas/TopicSource'
4133 $ref: '#/components/schemas/TopicSink'
4159 topicCommInfrastructure:
4200 topicCommInfrastructure:
4222 $ref: '#/components/schemas/ControllerConfiguration'
4223 additionalProperties:
4225 additionalProperties: