diff --git a/docs/ansible.utils.jsonschema_validate.rst b/docs/ansible.utils.jsonschema_validate.rst new file mode 100644 index 0000000..d55620f --- /dev/null +++ b/docs/ansible.utils.jsonschema_validate.rst @@ -0,0 +1,91 @@ +.. _ansible.utils.jsonschema_validate: + + +************************ +ansible.utils.jsonschema +************************ + +**Define configurable options for jsonschema validate sub-plugin (engine).** + + +Version added: 1.0.0 + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- This plugin documentation provides the configurable options when *ansible.utils.jsonschema* is used as a value for ``engine`` option within ``validate`` plugins. Refer individual ``validate`` plugin docs ``engine`` option for more details. + + + + +Parameters +---------- + +.. raw:: html + + + + + + + + + + + + + + +
ParameterChoices/DefaultsConfigurationComments
+
+ draft + +
+ - +
+
+
    Choices: +
  • draft3
  • +
  • draft4
  • +
  • draft6
  • +
  • draft7 ←
  • +
+
+
env:ANSIBLE_VALIDATE_JSONSCHEMA_DRAFT
+
var: ansible_validate_jsonschema_draft
+
+
This option provides the jsonschema specification that should be used for the validating the data. The criteria option in the validate plugin should follow the specifiaction as mentined by this option
+
+
+ + +Notes +----- + +.. note:: + - This sub-plugin is not a standalone pluign and works only when used with ``validate`` plugins. This plugin will be used when ``engine`` option of ``validate`` plugin is set to *ansible.utils.jsonschema*. + - The value of ``data`` option should be either of type *dict* or *strings* which should be a valid *dict* when read in python. + - The value of ``criteria`` should be *list* of *dict* or *list* of *strings* and each *string* within the *list* entry should be a valid *dict* when read in python. + + + + + + + +Status +------ + + +Authors +~~~~~~~ + +- Ganesh Nalawade (@ganeshrn) + + +.. hint:: + Configuration entries for each entry type have a low to high priority order. For example, a variable that is lower in the list will override a variable that is higher up.