` for details.
To use it in a playbook, specify: :code:`theforeman.foreman.content_view_filter_rule`.
.. version_added
.. rst-class:: ansible-version-added
New in theforeman.foreman 3.9.0
.. contents::
:local:
:depth: 1
.. Deprecated
Synopsis
--------
.. Description
- Create, manage and remove content view filter rules
.. Aliases
.. Requirements
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module_requirements:
Requirements
------------
The below requirements are needed on the host that executes this module.
- requests
.. Options
Parameters
----------
.. tabularcolumns:: \X{1}{3}\X{2}{3}
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
:class: longtable ansible-option-table
* - Parameter
- Comments
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-arch:
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-architecture:
.. rst-class:: ansible-option-title
**architecture**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-aliases:`aliases: arch`
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
set package, module\_stream, etc. architecture that the rule applies to
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-content_view:
.. rst-class:: ansible-option-title
**content_view**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
the name of the content view that the filter applies to
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-content_view_filter:
.. rst-class:: ansible-option-title
**content_view_filter**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
the name of the content view filter that the rule applies to
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-context:
.. rst-class:: ansible-option-title
**context**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
the context for a module
only valid in filter \ :emphasis:`type=modulemd`\
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-date_type:
.. rst-class:: ansible-option-title
**date_type**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
set whether rule applied to erratum using the 'Issued On' or 'Updated On' date
only valid on filter \ :emphasis:`type=erratum`\ .
.. rst-class:: ansible-option-line
:ansible-option-choices:`Choices:`
- :ansible-option-choices-entry:`"issued"`
- :ansible-option-choices-entry-default:`"updated"` :ansible-option-choices-default-mark:`← (default)`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-end_date:
.. rst-class:: ansible-option-title
**end_date**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
the rule limit for erratum end date (YYYY-MM-DD)
see date\_type for the date the rule applies to
Only valid on \ :emphasis:`filter\_type=erratum\_by\_date`\ .
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-errata_id:
.. rst-class:: ansible-option-title
**errata_id**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
erratum id
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-max_version:
.. rst-class:: ansible-option-title
**max_version**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
package maximum version
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-min_version:
.. rst-class:: ansible-option-title
**min_version**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
package minimum version
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-module_name:
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-name:
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-package_group:
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-package_name:
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-rule_name:
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-tag:
.. rst-class:: ansible-option-title
**name**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-aliases:`aliases: rule_name, module_name, package_name, package_group, tag`
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
Content view filter rule name, package name, package\_group name, module stream or docker tag
If omitted, the value of \ :emphasis:`name`\ will be used if necessary
for module stream filters, this is the name of the module stream to search for
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-organization:
.. rst-class:: ansible-option-title
**organization**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
Organization that the entity is in
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-password:
.. rst-class:: ansible-option-title
**password**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
Password of the user accessing the Foreman server.
If the value is not specified in the task, the value of environment variable \ :literal:`FOREMAN\_PASSWORD`\ will be used instead.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-server_url:
.. rst-class:: ansible-option-title
**server_url**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
URL of the Foreman server.
If the value is not specified in the task, the value of environment variable \ :literal:`FOREMAN\_SERVER\_URL`\ will be used instead.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-start_date:
.. rst-class:: ansible-option-title
**start_date**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
the rule limit for erratum start date (YYYY-MM-DD)
see date\_type for the date the rule applies to
Only valid on \ :emphasis:`filter\_type=erratum`\ .
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-state:
.. rst-class:: ansible-option-title
**state**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
State of the entity
.. rst-class:: ansible-option-line
:ansible-option-choices:`Choices:`
- :ansible-option-choices-entry-default:`"present"` :ansible-option-choices-default-mark:`← (default)`
- :ansible-option-choices-entry:`"absent"`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-stream:
.. rst-class:: ansible-option-title
**stream**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
the context for a module
only valid in filter \ :emphasis:`type=modulemd`\
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-types:
.. rst-class:: ansible-option-title
**types**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`list` / :ansible-option-elements:`elements=string`
.. raw:: html
- .. raw:: html
errata types the ruel applies to (enhancement, bugfix, security)
Only valid on \ :emphasis:`filter\_type=erratum`\
.. rst-class:: ansible-option-line
:ansible-option-default-bold:`Default:` :ansible-option-default:`["bugfix", "enhancement", "security"]`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-username:
.. rst-class:: ansible-option-title
**username**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string` / :ansible-option-required:`required`
.. raw:: html
- .. raw:: html
Username accessing the Foreman server.
If the value is not specified in the task, the value of environment variable \ :literal:`FOREMAN\_USERNAME`\ will be used instead.
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-validate_certs:
.. rst-class:: ansible-option-title
**validate_certs**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`boolean`
.. raw:: html
- .. raw:: html
Whether or not to verify the TLS certificates of the Foreman server.
If the value is not specified in the task, the value of environment variable \ :literal:`FOREMAN\_VALIDATE\_CERTS`\ will be used instead.
.. rst-class:: ansible-option-line
:ansible-option-choices:`Choices:`
- :ansible-option-choices-entry:`false`
- :ansible-option-choices-entry-default:`true` :ansible-option-choices-default-mark:`← (default)`
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__parameter-version:
.. rst-class:: ansible-option-title
**version**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`string`
.. raw:: html
- .. raw:: html
package or module version
.. raw:: html
.. Attributes
Attributes
----------
.. tabularcolumns:: \X{2}{10}\X{3}{10}\X{5}{10}
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
:class: longtable ansible-option-table
* - Attribute
- Support
- Description
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__attribute-check_mode:
.. rst-class:: ansible-option-title
**check_mode**
.. raw:: html
.. raw:: html
- .. raw:: html
:ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full`
.. raw:: html
- .. raw:: html
Can run in check\_mode and return changed status prediction without modifying the entity
.. raw:: html
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__attribute-diff_mode:
.. rst-class:: ansible-option-title
**diff_mode**
.. raw:: html
.. raw:: html
- .. raw:: html
:ansible-attribute-support-label:`Support: \ `\ :ansible-attribute-support-full:`full`
.. raw:: html
- .. raw:: html
Will return details on what has changed (or possibly needs changing in check\_mode), when in diff mode
.. raw:: html
.. Notes
.. Seealso
.. Examples
Examples
--------
.. code-block:: yaml+jinja
# the examples assume that the content view filters have been already created
# e.g. by the theforeman.foreman.content_view_filter module
- name: "Include errata by date"
theforeman.foreman.content_view_filter_rule:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
content_view: "Standard Operating Environment"
content_view_filter: "errata_by_date"
state: present
date_type: updated
types:
- bugfix
- security
- enhancement
end_date: "2022-05-25"
- name: "Exclude csh versions 6.20 and older"
theforeman.foreman.content_view_filter_rule:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
content_view: "Standard Operating Environment"
content_view_filter: "package filter 1"
name: "tcsh"
max_version: "6.20.00"
- name: "Exclude csh version 6.23 due to example policy"
theforeman.foreman.content_view_filter_rule:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
organization: "Default Organization"
content_view: "Standard Operating Environment"
content_view_filter: "package filter 1"
name: "tcsh"
version: "6.23.00"
- name: "Content View Filter Rule for 389"
theforeman.foreman.content_view_filter_rule:
username: "admin"
password: "changeme"
server_url: "https://foreman.example.com"
validate_certs: "true"
organization: "Default Organization"
content_view: "Standard Operating Environment"
content_view_filter: "modulemd filter"
name: "389-directory-server"
stream: "next"
version: "820220325123957"
context: "9edba152"
state: present
.. Facts
.. Return values
Return Values
-------------
Common return values are documented :ref:`here `, the following are the fields unique to this module:
.. tabularcolumns:: \X{1}{3}\X{2}{3}
.. list-table::
:width: 100%
:widths: auto
:header-rows: 1
:class: longtable ansible-option-table
* - Key
- Description
* - .. raw:: html
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__return-entity:
.. rst-class:: ansible-option-title
**entity**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`dictionary`
.. raw:: html
- .. raw:: html
Final state of the affected entities grouped by their type.
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` success
.. raw:: html
* - .. raw:: html
.. raw:: latex
\hspace{0.02\textwidth}\begin{minipage}[t]{0.3\textwidth}
.. _ansible_collections.theforeman.foreman.content_view_filter_rule_module__return-entity/content_view_filters_rules:
.. rst-class:: ansible-option-title
**content_view_filters_rules**
.. raw:: html
.. ansible-option-type-line::
:ansible-option-type:`list` / :ansible-option-elements:`elements=dictionary`
.. raw:: html
.. raw:: latex
\end{minipage}
- .. raw:: html
List of content view filter rule(s).
.. rst-class:: ansible-option-line
:ansible-option-returned-bold:`Returned:` success
.. raw:: html
.. Status (Presently only deprecated)
.. Authors
Authors
~~~~~~~
- Paul Armstrong (@parmstro)
.. Extra links
Collection links
~~~~~~~~~~~~~~~~
.. ansible-links::
- title: "Issue Tracker"
url: "https://github.com/theforeman/foreman-ansible-modules/issues"
external: true
- title: "Homepage"
url: "https://theforeman.org/"
external: true
- title: "Repository (Sources)"
url: "https://github.com/theforeman/foreman-ansible-modules"
external: true
.. Parsing errors