Update Policy Offered APIs

[policy/parent.git] / docs / xacml / decision-api.rst

diff --git a/docs/xacml/decision-api.rst b/docs/xacml/decision-api.rst
index e0d4f44..caf81b7 100644 (file)
--- a/docs/xacml/decision-api.rst
+++ b/docs/xacml/decision-api.rst
@@ -3,9 +3,15 @@
 .. _decision-api-label:
 
 Decision API
-#######################
+############
 
-The Decision API is used by ONAP components that enforce policies and need a decision on which policy to enforce for a specific situation. The Decision API mimics closely the XACML request standard in that it supports a subject, action and resource.
+The Decision API is used by ONAP components that enforce policies and need a decision on which policy to enforce for a
+specific situation. The Decision API mimics closely the XACML request standard in that it supports a subject, action
+and resource.
+
+When the PAP activates an xacml-pdp, the decision API becomes available. Conversely, when the PAP deactivates an xacml-pdp, the
+decision API is disabled. The decision API is enabled/disabled by the PDP-STATE-CHANGE messages from PAP. If a request is made
+to the decision API while it is deactivated, a "404 - Not Found" error will be returned.
 
 .. csv-table::
    :header: "Field", "Required", "XACML equivalent", "Description"
@@ -39,7 +45,11 @@ x-patchversion is used only to communicate a PATCH version in a response for tro
 
 x-onap-requestid is used to track REST transactions for logging purpose, as described above.
 
-.. swaggerv2doc:: swagger.json
+.. csv-table::
+   :header: "Swagger"
+   :widths: 10
+
+   `Decision API Swagger <./local-swagger.html>`_
 
 
 End of Document