From 3c711d14e242c18a9d58215224fd40374f7018e6 Mon Sep 17 00:00:00 2001 From: Saryu Shah Date: Wed, 4 Dec 2019 23:17:41 +0000 Subject: Document PAP policy notifications Document PAP policy notifications Issue-ID: POLICY-2270 Signed-off-by: Saryu Shah Change-Id: Ia2106165c3fa30951c36d1050e4db07835458589 --- docs/design/design.rst | 6 +++--- docs/pap/notification/dmaap-pap-notif.json | 23 +++++++++++++++++++++++ docs/pap/pap.rst | 8 ++++++++ 3 files changed, 34 insertions(+), 3 deletions(-) create mode 100644 docs/pap/notification/dmaap-pap-notif.json (limited to 'docs') diff --git a/docs/design/design.rst b/docs/design/design.rst index 84beb9e1..6f328940 100644 --- a/docs/design/design.rst +++ b/docs/design/design.rst @@ -396,9 +396,9 @@ pdp_subgroups R M N/A A list of PDP subgroups ->pdp_type R M N/A The PDP type of this PDP subgroup, currently xacml, drools, or apex ->supported_policy_types R N/A N/A A list of the policy types supported by the PDPs in this PDP - subgroup. A trailing “.*” can be used to specify multiple - policy types; for example, “onap.policies.monitoring.*” - would match any policy type beginning with + subgroup. A trailing “.*” can be used to specify multiple + policy types; for example, “onap.policies.monitoring.*” + would match any policy type beginning with “onap.policies.monitoring.” ->policies R M N/A The list of policies running on the PDPs in this PDP subgroup ->->(name) R M N/A The name of a TOSCA policy running in this PDP subgroup diff --git a/docs/pap/notification/dmaap-pap-notif.json b/docs/pap/notification/dmaap-pap-notif.json new file mode 100644 index 00000000..bfe9162b --- /dev/null +++ b/docs/pap/notification/dmaap-pap-notif.json @@ -0,0 +1,23 @@ +{ + "deployed-policies": [ + { + "policy-type": "onap.policies.monitoring.cdap.tca.hi.lo.app", + "policy-type-version": "1.0.0", + "policy-id": "onap.scaleout.tca", + "policy-version": "2.0.0", + "success-count": 3, + "failure-count": 0 + } + ], + "undeployed-policies": [ + { + "policy-type": "onap.policies.firewall", + "policy-type-version": "1.0.0", + "policy-id": "onap.firewall.tca", + "policy-version": "6.0.0", + "success-count": 3, + "failure-count": 0 + } + ] +} + diff --git a/docs/pap/pap.rst b/docs/pap/pap.rst index 97bcb825..d061c815 100644 --- a/docs/pap/pap.rst +++ b/docs/pap/pap.rst @@ -81,6 +81,14 @@ in the following table are transmitted via DMaaP: "PDP update", "Outgoing", "Assigns a PDP to a PDP Group and Subgroup; also deploys or undeploys policies from the PDP" "PDP state change", "Outgoing", "Changes the state of a PDP or all PDPs within a PDP Group or Subgroup" +In addition, PAP generates notifications via the DMaaP Message Router when policies are successfully or unsuccessfully +deployed (or undeployed) from all relevant PDPs. + +Here is a sample notification: + +.. literalinclude:: notification/dmaap-pap-notif.json + :language: json + 2 PAP REST API Swagger ====================== -- cgit 1.2.3-korg