pr*: style adjustments (#9524)

* pr*: style adjustments

* revert removal of "null"

* Update plugins/modules/redfish_command.py

* Update plugins/modules/redhat_subscription.py

Co-authored-by: Felix Fontein <felix@fontein.de>

---------

Co-authored-by: Felix Fontein <felix@fontein.de>
pull/9563/head
Alexei Znamensky 2025-01-09 08:41:03 +13:00 committed by GitHub
parent 3f7ea60766
commit 568fcea15e
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
48 changed files with 380 additions and 310 deletions

View File

@ -30,7 +30,8 @@ options:
type: str
node:
description:
- Specify which node of the cluster you want to manage. V(null) == the cluster status itself, V(all) == check the status of all nodes.
- Specify which node of the cluster you want to manage. V(null) == the cluster status itself, V(all) == check the status
of all nodes.
type: str
timeout:
description:

View File

@ -111,8 +111,10 @@ options:
state:
description:
- Desired state of the device.
- If set to V(present) (the default), the module call will return immediately after the device-creating HTTP request successfully returns.
- If set to V(active), the module call will block until all the specified devices are in state active due to the Packet API, or until O(wait_timeout).
- If set to V(present) (the default), the module call will return immediately after the device-creating HTTP request
successfully returns.
- If set to V(active), the module call will block until all the specified devices are in state active due to the Packet
API, or until O(wait_timeout).
choices: [present, absent, active, inactive, rebooted]
default: present
type: str
@ -133,7 +135,8 @@ options:
wait_timeout:
description:
- How long (seconds) to wait either for automatic IP address assignment, or for the device to reach the V(active) state.
- If O(wait_for_public_IPv) is set and O(state=active), the module will wait for both events consequently, applying the timeout twice.
- If O(wait_for_public_IPv) is set and O(state=active), the module will wait for both events consequently, applying
the timeout twice.
default: 900
type: int
@ -262,7 +265,7 @@ changed:
returned: success
devices:
description: Information about each device that was processed
description: Information about each device that was processed.
type: list
sample:
- {

View File

@ -75,9 +75,10 @@ options:
state:
description:
- Desired state of the IP subnet on the specified device.
- With O(state=present), you must specify either O(hostname) or O(device_id). Subnet with given CIDR will then be assigned to the specified
device.
- With O(state=absent), you can specify either O(hostname) or O(device_id). The subnet will be removed from specified devices.
- With O(state=present), you must specify either O(hostname) or O(device_id). Subnet with given CIDR will then be assigned
to the specified device.
- With O(state=absent), you can specify either O(hostname) or O(device_id). The subnet will be removed from specified
devices.
- If you leave both O(hostname) and O(device_id) empty, the subnet will be removed from any device it is assigned to.
choices: ['present', 'absent']
default: 'present'

View File

@ -18,8 +18,8 @@ short_description: Attach/detach a volume to a device in the Packet host
description:
- Attach/detach a volume to a device in the Packet host.
- API is documented at U(https://www.packet.com/developers/api/volumes/).
- This module creates the attachment route in the Packet API. In order to discover the block devices on the server, you have to run the Attach
Scripts, as documented at U(https://help.packet.net/technical/storage/packet-block-storage-linux).
- This module creates the attachment route in the Packet API. In order to discover the block devices on the server, you
have to run the Attach Scripts, as documented at U(https://help.packet.net/technical/storage/packet-block-storage-linux).
version_added: '0.2.0'
author:

View File

@ -32,7 +32,8 @@ attributes:
options:
name:
description:
- Name or list of names of the package(s) or file(s) to install, upgrade, or remove. Cannot be used in combination with O(upgrade).
- Name or list of names of the package(s) or file(s) to install, upgrade, or remove. Cannot be used in combination with
O(upgrade).
aliases: [package, pkg]
type: list
elements: str
@ -50,7 +51,8 @@ options:
force:
description:
- When removing packages, forcefully remove them, without any checks. Same as O(extra_args="--nodeps --nodeps").
- When combined with O(update_cache), force a refresh of all package databases. Same as O(update_cache_extra_args="--refresh --refresh").
- When combined with O(update_cache), force a refresh of all package databases. Same as O(update_cache_extra_args="--refresh
--refresh").
default: false
type: bool
@ -64,8 +66,8 @@ options:
executable:
description:
- Path of the binary to use. This can either be C(pacman) or a pacman compatible AUR helper.
- Pacman compatibility is unfortunately ill defined, in particular, this modules makes extensive use of the C(--print-format) directive
which is known not to be implemented by some AUR helpers (notably, C(yay)).
- Pacman compatibility is unfortunately ill defined, in particular, this modules makes extensive use of the C(--print-format)
directive which is known not to be implemented by some AUR helpers (notably, C(yay)).
- Beware that AUR helpers might behave unexpectedly and are therefore not recommended.
default: pacman
type: str
@ -82,8 +84,8 @@ options:
- Whether or not to refresh the master package lists.
- This can be run as part of a package installation or as a separate step.
- If not specified, it defaults to V(false).
- Please note that this option only had an influence on the module's C(changed) state if O(name) and O(upgrade) are not specified before
community.general 5.0.0. See the examples for how to keep the old behavior.
- Please note that this option only had an influence on the module's C(changed) state if O(name) and O(upgrade) are
not specified before community.general 5.0.0. See the examples for how to keep the old behavior.
type: bool
update_cache_extra_args:
@ -114,27 +116,29 @@ options:
reason_for:
description:
- Set the install reason for V(all) packages or only for V(new) packages.
- In case of O(state=latest) already installed packages which will be updated to a newer version are not counted as V(new).
- In case of O(state=latest) already installed packages which will be updated to a newer version are not counted as
V(new).
default: new
choices: [all, new]
type: str
version_added: 5.4.0
notes:
- When used with a C(loop:) each package will be processed individually, it is much more efficient to pass the list directly to the O(name)
option.
- To use an AUR helper (O(executable) option), a few extra setup steps might be required beforehand. For example, a dedicated build user with
permissions to install packages could be necessary.
- 'In the tests, while using C(yay) as the O(executable) option, the module failed to install AUR packages with the error: C(error: target not
found: <pkg>).'
- When used with a C(loop:) each package will be processed individually, it is much more efficient to pass the list directly
to the O(name) option.
- To use an AUR helper (O(executable) option), a few extra setup steps might be required beforehand. For example, a dedicated
build user with permissions to install packages could be necessary.
- 'In the tests, while using C(yay) as the O(executable) option, the module failed to install AUR packages with the error:
C(error: target not found: <pkg>).'
"""
RETURN = r"""
packages:
description:
- A list of packages that have been changed.
- Before community.general 4.5.0 this was only returned when O(upgrade=true). In community.general 4.5.0, it was sometimes omitted when the
package list is empty, but since community.general 4.6.0 it is always returned when O(name) is specified or O(upgrade=true).
- Before community.general 4.5.0 this was only returned when O(upgrade=true). In community.general 4.5.0, it was sometimes
omitted when the package list is empty, but since community.general 4.6.0 it is always returned when O(name) is specified
or O(upgrade=true).
returned: success and O(name) is specified or O(upgrade=true)
type: list
elements: str

View File

@ -79,7 +79,8 @@ options:
default: Created by Ansible
validate_certs:
description:
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using
self-signed certificates.
type: bool
default: true
"""

View File

@ -95,10 +95,11 @@ options:
desc:
type: str
description:
- For O(state=triggered) - Required. Short description of the problem that led to this trigger. This field (or a truncated version) will
be used when generating phone calls, SMS messages and alert emails. It will also appear on the incidents tables in the PagerDuty UI. The
maximum length is 1024 characters.
- For O(state=acknowledged) or O(state=resolved) - Text that will appear in the incident's log associated with this event.
- For O(state=triggered) - Required. Short description of the problem that led to this trigger. This field (or a truncated
version) will be used when generating phone calls, SMS messages and alert emails. It will also appear on the incidents
tables in the PagerDuty UI. The maximum length is 1024 characters.
- For O(state=acknowledged) or O(state=resolved) - Text that will appear in the incident's log associated with this
event.
required: false
default: Created via Ansible
incident_class:
@ -111,11 +112,12 @@ options:
type: str
description:
- Identifies the incident to which this O(state) should be applied.
- For O(state=triggered) - If there is no open (in other words unresolved) incident with this key, a new one will be created. If there is already an
open incident with a matching key, this event will be appended to that incident's log. The event key provides an easy way to 'de-dup'
problem reports. If no O(incident_key) is provided, then it will be generated by PagerDuty.
- For O(state=acknowledged) or O(state=resolved) - This should be the incident_key you received back when the incident was first opened
by a trigger event. Acknowledge events referencing resolved or nonexistent incidents will be discarded.
- For O(state=triggered) - If there is no open (in other words unresolved) incident with this key, a new one will be
created. If there is already an open incident with a matching key, this event will be appended to that incident's
log. The event key provides an easy way to 'de-dup' problem reports. If no O(incident_key) is provided, then it will
be generated by PagerDuty.
- For O(state=acknowledged) or O(state=resolved) - This should be the incident_key you received back when the incident
was first opened by a trigger event. Acknowledge events referencing resolved or nonexistent incidents will be discarded.
required: false
link_url:
type: str

View File

@ -31,7 +31,8 @@ attributes:
options:
integration_key:
description:
- The integration key that identifies the service the change was made to. This can be found by adding an integration to a service in PagerDuty.
- The integration key that identifies the service the change was made to. This can be found by adding an integration
to a service in PagerDuty.
required: true
type: str
summary:
@ -81,8 +82,8 @@ options:
type: str
validate_certs:
description:
- If V(false), SSL certificates for the target URL will not be validated. This should only be used on personally controlled sites using
self-signed certificates.
- If V(false), SSL certificates for the target URL will not be validated. This should only be used on personally controlled
sites using self-signed certificates.
required: false
default: true
type: bool

View File

@ -73,21 +73,24 @@ options:
required: true
backup:
description:
- Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
- Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered
it incorrectly.
required: false
type: bool
default: false
use_min:
description:
- If set to V(true), the minimal value will be used or conserved.
- If the specified value is inferior to the value in the file, file content is replaced with the new value, else content is not modified.
- If the specified value is inferior to the value in the file, file content is replaced with the new value, else content
is not modified.
required: false
type: bool
default: false
use_max:
description:
- If set to V(true), the maximal value will be used or conserved.
- If the specified value is superior to the value in the file, file content is replaced with the new value, else content is not modified.
- If the specified value is superior to the value in the file, file content is replaced with the new value, else content
is not modified.
required: false
type: bool
default: false

View File

@ -16,7 +16,8 @@ author:
short_description: Manage PAM Modules
description:
- Edit PAM service's type, control, module path and module arguments.
- In order for a PAM rule to be modified, the type, control and module_path must match an existing rule. See man(5) pam.d for details.
- In order for a PAM rule to be modified, the type, control and module_path must match an existing rule. See man(5) pam.d
for details.
notes:
- This module does not handle authselect profiles.
extends_documentation_fragment:
@ -70,7 +71,8 @@ options:
- When O(state=updated), the O(module_arguments) will replace existing module_arguments.
- When O(state=args_absent) args matching those listed in O(module_arguments) will be removed.
- When O(state=args_present) any args listed in O(module_arguments) are added if missing from the existing rule.
- Furthermore, if the module argument takes a value denoted by C(=), the value will be changed to that specified in module_arguments.
- Furthermore, if the module argument takes a value denoted by C(=), the value will be changed to that specified in
module_arguments.
type: list
elements: str
state:
@ -91,7 +93,8 @@ options:
default: /etc/pam.d
backup:
description:
- Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
- Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered
it incorrectly.
type: bool
default: false
"""
@ -151,11 +154,7 @@ EXAMPLES = r"""
type: auth
control: required
module_path: pam_faillock.so
module_arguments: 'preauth
silent
deny=3
unlock_time=604800
fail_interval=900'
module_arguments: 'preauth silent deny=3 unlock_time=604800 fail_interval=900'
state: updated
- name: Remove specific arguments from a rule

View File

@ -15,8 +15,8 @@ author:
module: parted
short_description: Configure block device partitions
description:
- This module allows configuring block device partition using the C(parted) command line tool. For a full description of the fields and the
options check the GNU parted manual.
- This module allows configuring block device partition using the C(parted) command line tool. For a full description of
the fields and the options check the GNU parted manual.
requirements:
- This module requires C(parted) version 1.8.3 and above.
- Option O(align) (except V(undefined)) requires C(parted) 2.1 or above.
@ -33,7 +33,8 @@ options:
device:
description:
- The block device (disk) where to operate.
- Regular files can also be partitioned, but it is recommended to create a loopback device using C(losetup) to easily access its partitions.
- Regular files can also be partitioned, but it is recommended to create a loopback device using C(losetup) to easily
access its partitions.
type: str
required: true
align:
@ -49,8 +50,8 @@ options:
type: int
unit:
description:
- Selects the current default unit that Parted will use to display locations and capacities on the disk and to interpret those given by
the user if they are not suffixed by an unit.
- Selects the current default unit that Parted will use to display locations and capacities on the disk and to interpret
those given by the user if they are not suffixed by an unit.
- When fetching information about a disk, it is recommended to always specify a unit.
type: str
choices: [s, B, KB, KiB, MB, MiB, GB, GiB, TB, TiB, '%', cyl, chs, compact]
@ -58,7 +59,8 @@ options:
label:
description:
- Disk label type or partition table to use.
- If O(device) already contains a different label, it will be changed to O(label) and any previous partitions will be lost.
- If O(device) already contains a different label, it will be changed to O(label) and any previous partitions will be
lost.
- A O(name) must be specified for a V(gpt) partition table.
type: str
choices: [aix, amiga, bsd, dvh, gpt, loop, mac, msdos, pc98, sun]
@ -72,17 +74,19 @@ options:
default: primary
part_start:
description:
- Where the partition will start as offset from the beginning of the disk, that is, the "distance" from the start of the disk. Negative
numbers specify distance from the end of the disk.
- The distance can be specified with all the units supported by parted (except compat) and it is case sensitive, for example V(10GiB), V(15%).
- Where the partition will start as offset from the beginning of the disk, that is, the "distance" from the start of
the disk. Negative numbers specify distance from the end of the disk.
- The distance can be specified with all the units supported by parted (except compat) and it is case sensitive, for
example V(10GiB), V(15%).
- Using negative values may require setting of O(fs_type) (see notes).
type: str
default: 0%
part_end:
description:
- Where the partition will end as offset from the beginning of the disk, that is, the "distance" from the start of the disk. Negative numbers
specify distance from the end of the disk.
- The distance can be specified with all the units supported by parted (except compat) and it is case sensitive, for example V(10GiB), V(15%).
- Where the partition will end as offset from the beginning of the disk, that is, the "distance" from the start of the
disk. Negative numbers specify distance from the end of the disk.
- The distance can be specified with all the units supported by parted (except compat) and it is case sensitive, for
example V(10GiB), V(15%).
type: str
default: 100%
name:
@ -114,10 +118,11 @@ options:
version_added: '1.3.0'
notes:
- When fetching information about a new disk and when the version of parted installed on the system is before version 3.1, the module queries
the kernel through C(/sys/) to obtain disk information. In this case the units CHS and CYL are not supported.
- Negative O(part_start) start values were rejected if O(fs_type) was not given. This bug was fixed in parted 3.2.153. If you want to use negative
O(part_start), specify O(fs_type) as well or make sure your system contains newer parted.
- When fetching information about a new disk and when the version of parted installed on the system is before version 3.1,
the module queries the kernel through C(/sys/) to obtain disk information. In this case the units CHS and CYL are not
supported.
- Negative O(part_start) start values were rejected if O(fs_type) was not given. This bug was fixed in parted 3.2.153. If
you want to use negative O(part_start), specify O(fs_type) as well or make sure your system contains newer parted.
"""
RETURN = r"""

View File

@ -45,11 +45,13 @@ options:
- Path to the pear executable.
prompts:
description:
- List of regular expressions that can be used to detect prompts during pear package installation to answer the expected question.
- List of regular expressions that can be used to detect prompts during pear package installation to answer the expected
question.
- Prompts will be processed in the same order as the packages list.
- You can optionally specify an answer to any question in the list.
- If no answer is provided, the list item will only contain the regular expression.
- "To specify an answer, the item will be a dict with the regular expression as key and the answer as value C(my_regular_expression: 'an_answer')."
- "To specify an answer, the item will be a dict with the regular expression as key and the answer as value C(my_regular_expression:
'an_answer')."
- You can provide a list containing items with or without answer.
- A prompt list can be shorter or longer than the packages list but will issue a warning.
- If you want to specify that a package will not need prompts in the middle of a list, V(null).
@ -83,9 +85,9 @@ EXAMPLES = r"""
prompts:
- (.*)Enable internal debugging in APCu \[no\]: "yes"
- name: Install multiple pear/pecl packages at once with prompts. Prompts will be processed on the same order as the packages order. If there
is more prompts than packages, packages without prompts will be installed without any prompt expected. If there is more packages than prompts,
additional prompts will be ignored.
- name: Install multiple pear/pecl packages at once with prompts. Prompts will be processed on the same order as the packages
order. If there is more prompts than packages, packages without prompts will be installed without any prompt expected.
If there is more packages than prompts, additional prompts will be ignored.
community.general.pear:
name: pecl/gnupg, pecl/apcu
state: present
@ -93,9 +95,9 @@ EXAMPLES = r"""
- I am a test prompt because gnupg doesnt asks anything
- (.*)Enable internal debugging in APCu \[no\]: "yes"
- name: Install multiple pear/pecl packages at once skipping the first prompt. Prompts will be processed on the same order as the packages order.
If there is more prompts than packages, packages without prompts will be installed without any prompt expected. If there is more packages
than prompts, additional prompts will be ignored.
- name: Install multiple pear/pecl packages at once skipping the first prompt. Prompts will be processed on the same order
as the packages order. If there is more prompts than packages, packages without prompts will be installed without any
prompt expected. If there is more packages than prompts, additional prompts will be ignored.
community.general.pear:
name: pecl/gnupg, pecl/apcu
state: present

View File

@ -9,8 +9,8 @@ __metaclass__ = type
DOCUMENTATION = r"""
module: pids
description: "Retrieves a list of PIDs of given process name in Ansible controller/controlled machines.Returns an empty list if no process in
that name exists."
description: "Retrieves a list of PIDs of given process name in Ansible controller/controlled machines. Returns an empty list
if no process in that name exists."
short_description: Retrieves process IDs list if the process is running otherwise return empty list
author:
- Saranya Sridharan (@saranyasridharan)

View File

@ -20,8 +20,8 @@ extends_documentation_fragment:
options:
clients:
description:
- A list of the pip executables that will be used to get the packages. They can be supplied with the full path or just the executable name,
for example V(pip3.7).
- A list of the pip executables that will be used to get the packages. They can be supplied with the full path or just
the executable name, for example V(pip3.7).
default: ['pip']
required: false
type: list

View File

@ -47,24 +47,28 @@ options:
description:
- Desired state for the application.
- The states V(present) and V(absent) are aliases to V(install) and V(uninstall), respectively.
- The state V(latest) is equivalent to executing the task twice, with state V(install) and then V(upgrade). It was added in community.general
5.5.0.
- The states V(install_all), V(uninject), V(upgrade_shared), V(pin) and V(unpin) are only available in C(pipx>=1.6.0), make sure to have
a compatible version when using this option. These states have been added in community.general 9.4.0.
- The state V(latest) is equivalent to executing the task twice, with state V(install) and then V(upgrade). It was added
in community.general 5.5.0.
- The states V(install_all), V(uninject), V(upgrade_shared), V(pin) and V(unpin) are only available in C(pipx>=1.6.0),
make sure to have a compatible version when using this option. These states have been added in community.general 9.4.0.
name:
type: str
description:
- The name of the application. In C(pipx) documentation it is also referred to as the name of the virtual environment where the application
will be installed.
- If O(name) is a simple package name without version specifiers, then that name is used as the Python package name to be installed.
- The name of the application. In C(pipx) documentation it is also referred to as the name of the virtual environment
where the application will be installed.
- If O(name) is a simple package name without version specifiers, then that name is used as the Python package name
to be installed.
- Use O(source) for passing package specifications or installing from URLs or directories.
source:
type: str
description:
- Source for the package. This option is used when O(state=install) or O(state=latest), and it is ignored with other states.
- Use O(source) when installing a Python package with version specifier, or from a local path, from a VCS URL or compressed file.
- Source for the package. This option is used when O(state=install) or O(state=latest), and it is ignored with other
states.
- Use O(source) when installing a Python package with version specifier, or from a local path, from a VCS URL or compressed
file.
- The value of this option is passed as-is to C(pipx).
- O(name) is still required when using O(source) to establish the application name without fetching the package from a remote source.
- O(name) is still required when using O(source) to establish the application name without fetching the package from
a remote source.
install_apps:
description:
- Add apps from the injected packages.
@ -136,14 +140,14 @@ options:
spec_metadata:
description:
- Spec metadata file for O(state=install_all).
- This content of the file is usually generated with C(pipx list --json), and it can be obtained with M(community.general.pipx_info) with
O(community.general.pipx_info#module:include_raw=true) and obtaining the content from the RV(community.general.pipx_info#module:raw_output).
- This content of the file is usually generated with C(pipx list --json), and it can be obtained with M(community.general.pipx_info)
with O(community.general.pipx_info#module:include_raw=true) and obtaining the content from the RV(community.general.pipx_info#module:raw_output).
type: path
version_added: 9.4.0
notes:
- This first implementation does not verify whether a specified version constraint has been installed or not. Hence, when using version operators,
C(pipx) module will always try to execute the operation, even when the application was previously installed. This feature will be added in
the future.
- This first implementation does not verify whether a specified version constraint has been installed or not. Hence, when
using version operators, C(pipx) module will always try to execute the operation, even when the application was previously
installed. This feature will be added in the future.
author:
- "Alexei Znamensky (@russoz)"
"""

View File

@ -26,7 +26,8 @@ author:
- "Shaun Zinck (@szinck)"
- "Jasper Lievisse Adriaanse (@jasperla)"
notes:
- 'Known bug with pkgin < 0.8.0: if a package is removed and another package depends on it, the other package will be silently removed as well.'
- 'Known bug with pkgin < 0.8.0: if a package is removed and another package depends on it, the other package will be silently
removed as well.'
extends_documentation_fragment:
- community.general.attributes
attributes:

View File

@ -50,15 +50,16 @@ options:
default: false
annotation:
description:
- A list of keyvalue-pairs of the form C(<+/-/:><key>[=<value>]). A V(+) denotes adding an annotation, a V(-) denotes removing an annotation,
and V(:) denotes modifying an annotation. If setting or modifying annotations, a value must be provided.
- A list of keyvalue-pairs of the form C(<+/-/:><key>[=<value>]). A V(+) denotes adding an annotation, a V(-) denotes
removing an annotation, and V(:) denotes modifying an annotation. If setting or modifying annotations, a value must
be provided.
required: false
type: list
elements: str
pkgsite:
description:
- For C(pkgng) versions before 1.1.4, specify C(packagesite) to use for downloading packages.
If not specified, use settings from C(/usr/local/etc/pkg.conf).
- For C(pkgng) versions before 1.1.4, specify C(packagesite) to use for downloading packages. If not specified, use
settings from C(/usr/local/etc/pkg.conf).
- For newer C(pkgng) versions, specify a the name of a repository configured in C(/usr/local/etc/pkg/repos).
required: false
type: str
@ -76,7 +77,7 @@ options:
type: path
jail:
description:
- Pkg will execute in the given jail name or id.
- Pkg will execute in the given jail name or ID.
- Can not be used together with O(chroot) or O(rootdir) options.
type: str
autoremove:
@ -103,8 +104,8 @@ options:
author: "bleader (@bleader)"
notes:
- When using pkgsite, be careful that already in cache packages will not be downloaded again.
- When used with a C(loop:) each package will be processed individually, it is much more efficient to pass the list directly to the O(name)
option.
- When used with a C(loop:) each package will be processed individually, it is much more efficient to pass the list directly
to the O(name) option.
"""
EXAMPLES = r"""

View File

@ -28,7 +28,8 @@ attributes:
check_mode:
support: full
details:
- In order to check the availability of packages, the catalog cache under C(/var/opt/csw/pkgutil) may be refreshed even in check mode.
- In order to check the availability of packages, the catalog cache under C(/var/opt/csw/pkgutil) may be refreshed even
in check mode.
diff_mode:
support: none
options:

View File

@ -14,7 +14,8 @@ module: pmem
short_description: Configure Intel Optane Persistent Memory modules
version_added: 4.5.0
description:
- This module allows Configuring Intel Optane Persistent Memory modules (PMem) using C(ipmctl) and C(ndctl) command line tools.
- This module allows Configuring Intel Optane Persistent Memory modules (PMem) using C(ipmctl) and C(ndctl) command line
tools.
requirements:
- C(ipmctl) and C(ndctl) command line tools
- xmltodict
@ -29,7 +30,8 @@ options:
appdirect:
description:
- Percentage of the total capacity to use in AppDirect Mode (V(0)-V(100)).
- Create AppDirect capacity utilizing hardware interleaving across the requested PMem modules if applicable given the specified target.
- Create AppDirect capacity utilizing hardware interleaving across the requested PMem modules if applicable given the
specified target.
- Total of O(appdirect), O(memorymode) and O(reserved) must be V(100).
type: int
appdirect_interleaved:
@ -44,8 +46,8 @@ options:
type: int
reserved:
description:
- Percentage of the capacity to reserve (V(0)-V(100)). O(reserved) will not be mapped into the system physical address space and will be
presented as reserved capacity with Show Device and Show Memory Resources Commands.
- Percentage of the capacity to reserve (V(0)-V(100)). O(reserved) will not be mapped into the system physical address
space and will be presented as reserved capacity with Show Device and Show Memory Resources Commands.
- O(reserved) will be set automatically if this is not configured.
type: int
required: false
@ -100,8 +102,8 @@ options:
choices: ['pmem', 'blk']
size:
description:
- The size of namespace. This option supports the suffixes V(k) or V(K) or V(KB) for KiB, V(m) or V(M) or V(MB) for MiB, V(g) or V(G)
or V(GB) for GiB and V(t) or V(T) or V(TB) for TiB.
- The size of namespace. This option supports the suffixes V(k) or V(K) or V(KB) for KiB, V(m) or V(M) or V(MB)
for MiB, V(g) or V(G) or V(GB) for GiB and V(t) or V(T) or V(TB) for TiB.
- This option is required if multiple namespaces are configured.
- If this option is not set, all of the available space of a region is configured.
type: str

View File

@ -173,7 +173,8 @@ options:
loadavg:
description:
- Specifies that no new builds should be started if there are other builds running and the load average is at least LOAD.
- Specifies that no new builds should be started if there are other builds running and the load average is at least
LOAD.
- 'Since version 2.6: Value of 0 or False resets any previously added C(--load-average) setting values.'
type: float

View File

@ -35,8 +35,9 @@ options:
type: bool
default: false
description:
- If O(force) is V(true) and O(state) is V(absent), the module will delete the organization, no matter if it contains users or not. By default
O(force) is V(false), which will cause the module to fail the deletion of the organization when it contains users.
- If O(force) is V(true) and O(state) is V(absent), the module will delete the organization, no matter if it contains
users or not. By default O(force) is V(false), which will cause the module to fail the deletion of the organization
when it contains users.
state:
type: str
default: 'present'
@ -44,8 +45,8 @@ options:
- present
- absent
description:
- If V(present), the module adds organization O(name) to Pritunl. If V(absent), attempt to delete the organization from Pritunl (please
read about O(force) usage).
- If V(present), the module adds organization O(name) to Pritunl. If V(absent), attempt to delete the organization from
Pritunl (please read about O(force) usage).
"""
EXAMPLES = r"""

View File

@ -38,8 +38,8 @@ options:
- present
- absent
description:
- If V(present), the module adds user O(user_name) to the Pritunl O(organization). If V(absent), removes the user O(user_name) from the
Pritunl O(organization).
- If V(present), the module adds user O(user_name) to the Pritunl O(organization). If V(absent), removes the user O(user_name)
from the Pritunl O(organization).
user_name:
type: str
required: true

View File

@ -12,8 +12,8 @@ DOCUMENTATION = r"""
module: profitbricks
short_description: Create, destroy, start, stop, and reboot a ProfitBricks virtual machine
description:
- Create, destroy, update, start, stop, and reboot a ProfitBricks virtual machine. When the virtual machine is created it can optionally wait
for it to be 'running' before returning. This module has a dependency on profitbricks >= 1.0.0.
- Create, destroy, update, start, stop, and reboot a ProfitBricks virtual machine. When the virtual machine is created it
can optionally wait for it to be 'running' before returning. This module has a dependency on profitbricks >= 1.0.0.
extends_documentation_fragment:
- community.general.attributes
attributes:
@ -78,7 +78,7 @@ options:
choices: ["IDE", "VIRTIO"]
instance_ids:
description:
- List of instance ids, currently only used when state='absent' to remove instances.
- List of instance IDs, currently only used when state='absent' to remove instances.
type: list
elements: str
default: []

View File

@ -12,8 +12,8 @@ DOCUMENTATION = r"""
module: profitbricks_datacenter
short_description: Create or destroy a ProfitBricks Virtual Datacenter
description:
- This is a simple module that supports creating or removing vDCs. A vDC is required before you can create servers. This module has a dependency
on profitbricks >= 1.0.0.
- This is a simple module that supports creating or removing vDCs. A vDC is required before you can create servers. This
module has a dependency on profitbricks >= 1.0.0.
extends_documentation_fragment:
- community.general.attributes
attributes:

View File

@ -12,7 +12,8 @@ DOCUMENTATION = r"""
module: profitbricks_volume
short_description: Create or destroy a volume
description:
- Allows you to create or remove a volume from a ProfitBricks datacenter. This module has a dependency on profitbricks >= 1.0.0.
- Allows you to create or remove a volume from a ProfitBricks datacenter. This module has a dependency on profitbricks >=
1.0.0.
extends_documentation_fragment:
- community.general.attributes
attributes:
@ -44,7 +45,8 @@ options:
choices: ["IDE", "VIRTIO"]
image:
description:
- The system image ID for the volume, for example V(a3eae284-a2fe-11e4-b187-5f1f641608c8). This can also be a snapshot image ID.
- The system image ID for the volume, for example V(a3eae284-a2fe-11e4-b187-5f1f641608c8). This can also be a snapshot
image ID.
type: str
image_password:
description:
@ -84,7 +86,7 @@ options:
type: bool
instance_ids:
description:
- List of instance ids, currently only used when state='absent' to remove instances.
- List of instance IDs, currently only used when O(state=absent) to remove instances.
type: list
elements: str
default: []

View File

@ -40,11 +40,13 @@ options:
type: str
disk:
description:
- This option was previously described as "hard disk size in GB for instance" however several formats describing a lxc mount are permitted.
- Older versions of Proxmox will accept a numeric value for size using the O(storage) parameter to automatically choose which storage to
allocate from, however new versions enforce the C(<STORAGE>:<SIZE>) syntax.
- Additional options are available by using some combination of the following key-value pairs as a comma-delimited list C([volume=]<volume>
[,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>] [,size=<DiskSize>]).
- This option was previously described as "hard disk size in GB for instance" however several formats describing a lxc
mount are permitted.
- Older versions of Proxmox will accept a numeric value for size using the O(storage) parameter to automatically choose
which storage to allocate from, however new versions enforce the C(<STORAGE>:<SIZE>) syntax.
- Additional options are available by using some combination of the following key-value pairs as a comma-delimited list
C([volume=]<volume> [,acl=<1|0>] [,mountoptions=<opt[;opt...]>] [,quota=<1|0>] [,replicate=<1|0>] [,ro=<1|0>] [,shared=<1|0>]
[,size=<DiskSize>]).
- See U(https://pve.proxmox.com/wiki/Linux_Container) for a full description.
- This option is mutually exclusive with O(storage) and O(disk_volume).
type: str
@ -114,7 +116,8 @@ options:
startup:
description:
- Specifies the startup order of the container.
- Use C(order=#) where C(#) is a non-negative number to define the general startup order. Shutdown in done with reverse ordering.
- Use C(order=#) where C(#) is a non-negative number to define the general startup order. Shutdown in done with reverse
ordering.
- Use C(up=#) where C(#) is in seconds, to specify a delay to wait before the next VM is started.
- Use C(down=#) where C(#) is in seconds, to specify a delay to wait before the next VM is stopped.
type: list
@ -190,7 +193,8 @@ options:
description:
- Specifies the C(ostype) of the LXC container.
- If set to V(auto), no C(ostype) will be provided on instance creation.
choices: ['auto', 'debian', 'devuan', 'ubuntu', 'centos', 'fedora', 'opensuse', 'archlinux', 'alpine', 'gentoo', 'nixos', 'unmanaged']
choices: ['auto', 'debian', 'devuan', 'ubuntu', 'centos', 'fedora', 'opensuse', 'archlinux', 'alpine', 'gentoo', 'nixos',
'unmanaged']
type: str
default: 'auto'
version_added: 8.1.0
@ -289,8 +293,8 @@ options:
- Type of the clone created.
- V(full) creates a full clone, and O(storage) must be specified.
- V(linked) creates a linked clone, and the cloned container must be a template container.
- V(opportunistic) creates a linked clone if the cloned container is a template container, and a full clone if not. O(storage) may be specified,
if not it will fall back to the default.
- V(opportunistic) creates a linked clone if the cloned container is a template container, and a full clone if not.
O(storage) may be specified, if not it will fall back to the default.
type: str
choices: ['full', 'linked', 'opportunistic']
default: opportunistic

View File

@ -17,8 +17,10 @@ short_description: Start a VM backup in Proxmox VE cluster
version_added: 10.1.0
description:
- Allows you to create backups of KVM and LXC guests in Proxmox VE cluster.
- Offers the GUI functionality of creating a single backup as well as using the run-now functionality from the cluster backup schedule.
- The mininum required privileges to use this module are C(VM.Backup) and C(Datastore.AllocateSpace) for the respective VMs and storage.
- Offers the GUI functionality of creating a single backup as well as using the run-now functionality from the cluster backup
schedule.
- The mininum required privileges to use this module are C(VM.Backup) and C(Datastore.AllocateSpace) for the respective
VMs and storage.
- Most options are optional and if unspecified will be chosen by the Cluster and its default values.
- Note that this module B(is not idempotent). It always starts a new backup (when not in check mode).
attributes:
@ -60,9 +62,10 @@ options:
description:
- Specify the description of the backup.
- Needs to be a single line, newline and backslash need to be escaped as V(\\n) and V(\\\\) respectively.
- If you need variable interpolation, you can set the content as usual through ansible jinja templating and/or let Proxmox substitute templates.
- Proxmox currently supports V({{cluster}}), V({{guestname}}), V({{node}}), and V({{vmid}}) as templating variables. Since this is also
a jinja delimiter, you need to set these values as raw jinja.
- If you need variable interpolation, you can set the content as usual through ansible jinja templating and/or let Proxmox
substitute templates.
- Proxmox currently supports V({{cluster}}), V({{guestname}}), V({{node}}), and V({{vmid}}) as templating variables.
Since this is also a jinja delimiter, you need to set these values as raw jinja.
default: "{{guestname}}"
type: str
fleecing:
@ -109,8 +112,8 @@ options:
description:
- Use custom retention options instead of those from the default cluster configuration (which is usually V("keep-all=1")).
- Always requires Datastore.Allocate permission at the storage endpoint.
- Specifying a retention time other than V(keep-all=1) might trigger pruning on the datastore, if an existing backup should be deleted
due to your specified timeframe.
- Specifying a retention time other than V(keep-all=1) might trigger pruning on the datastore, if an existing backup
should be deleted due to your specified timeframe.
- Deleting requires C(Datastore.Modify) or C(Datastore.Prune) permissions on the backup storage.
type: str
storage:
@ -120,7 +123,7 @@ options:
required: true
vmids:
description:
- The instance ids to be backed up.
- The instance IDs to be backed up.
- Only valid, if O(mode=include).
type: list
elements: int
@ -212,8 +215,8 @@ backups:
choices: ["unknown", "success", "failed"]
upid:
description: >-
Proxmox cluster UPID, which is needed to lookup task info. Returns OK, when a cluster node did not create a task after being called, for
example due to no matching targets.
Proxmox cluster UPID, which is needed to lookup task info. Returns OK, when a cluster node did not create a task after
being called, for example due to no matching targets.
returned: on success
type: str
"""

View File

@ -43,15 +43,16 @@ options:
state:
description:
- Indicates desired state of the disk.
- O(state=present) can be used to create, replace disk or update options in existing disk. It will create missing disk or update options
in existing one by default. See the O(create) parameter description to control behavior of this option.
- O(state=present) can be used to create, replace disk or update options in existing disk. It will create missing disk
or update options in existing one by default. See the O(create) parameter description to control behavior of this
option.
- Some updates on options (like O(cache)) are not being applied instantly and require VM restart.
- Use O(state=detached) to detach existing disk from VM but do not remove it entirely. When O(state=detached) and disk is V(unused[n]) it
will be left in same state (not removed).
- O(state=moved) may be used to change backing storage for the disk in bounds of the same VM or to send the disk to another VM (using the
same backing storage).
- O(state=resized) intended to change the disk size. As of Proxmox 7.2 you can only increase the disk size because shrinking disks is not
supported by the PVE API and has to be done manually.
- Use O(state=detached) to detach existing disk from VM but do not remove it entirely. When O(state=detached) and disk
is V(unused[n]) it will be left in same state (not removed).
- O(state=moved) may be used to change backing storage for the disk in bounds of the same VM or to send the disk to
another VM (using the same backing storage).
- O(state=resized) intended to change the disk size. As of Proxmox 7.2 you can only increase the disk size because shrinking
disks is not supported by the PVE API and has to be done manually.
- To entirely remove the disk from backing storage use O(state=absent).
type: str
choices: ['present', 'resized', 'detached', 'moved', 'absent']
@ -73,8 +74,8 @@ options:
size:
description:
- Desired volume size in GB to allocate when O(state=present) (specify O(size) without suffix).
- New (or additional) size of volume when O(state=resized). With the V(+) sign the value is added to the actual size of the volume and without
it, the value is taken as an absolute one.
- New (or additional) size of volume when O(state=resized). With the V(+) sign the value is added to the actual size
of the volume and without it, the value is taken as an absolute one.
type: str
bwlimit:
description:

View File

@ -35,8 +35,8 @@ options:
agent:
description:
- Specify if the QEMU Guest Agent should be enabled/disabled.
- Since community.general 5.5.0, this can also be a string instead of a boolean.
This allows to specify values such as V(enabled=1,fstrim_cloned_disks=1).
- Since community.general 5.5.0, this can also be a string instead of a boolean. This allows to specify values such
as V(enabled=1,fstrim_cloned_disks=1).
type: str
args:
description:
@ -97,7 +97,8 @@ options:
version_added: 1.3.0
clone:
description:
- Name of VM to be cloned. If O(vmid) is set, O(clone) can take an arbitrary value but is required for initiating the clone.
- Name of VM to be cloned. If O(vmid) is set, O(clone) can take an arbitrary value but is required for initiating the
clone.
type: str
cores:
description:
@ -143,22 +144,24 @@ options:
type: str
format:
description:
- V(format) is the drive's backing file's data format. Please refer to the Proxmox VE Administrator Guide, section Proxmox VE Storage
(see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format supported by
the provided storage backend.
- V(format) is the drive's backing file's data format. Please refer to the Proxmox VE Administrator Guide, section
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables
3 to 14) to find out format supported by the provided storage backend.
type: str
efitype:
description:
- V(efitype) indicates the size of the EFI disk.
- V(2m) will allow for a 2MB EFI disk, which will be enough to persist boot order and new boot entries.
- V(4m) will allow for a 4MB EFI disk, which will additionally allow to store EFI keys in order to enable Secure Boot.
- V(4m) will allow for a 4MB EFI disk, which will additionally allow to store EFI keys in order to enable Secure
Boot.
type: str
choices:
- 2m
- 4m
pre_enrolled_keys:
description:
- V(pre_enrolled_keys) indicates whether EFI keys for Secure Boot should be enrolled V(1) in the VM firmware upon creation or not (0).
- V(pre_enrolled_keys) indicates whether EFI keys for Secure Boot should be enrolled V(1) in the VM firmware upon
creation or not (0).
- If set to V(1), Secure Boot will also be enabled by default when the VM is created.
type: bool
version_added: 4.5.0
@ -203,7 +206,8 @@ options:
- V(pcie=boolean) V(default=0) Choose the PCI-express bus (needs the q35 machine model).
- V(rombar=boolean) V(default=1) Specify whether or not the device's ROM will be visible in the guest's memory map.
- V(x-vga=boolean) V(default=0) Enable vfio-vga device support.
- /!\ This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
- /!\ This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use
with special care.
type: dict
hotplug:
description:
@ -223,9 +227,9 @@ options:
- Values allowed are - V("storage:size,format=value").
- V(storage) is the storage identifier where to create the disk.
- V(size) is the size of the disk in GB.
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
supported by the provided storage backend.
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
tables 3 to 14) to find out format supported by the provided storage backend.
type: dict
ipconfig:
description:
@ -300,11 +304,13 @@ options:
- A hash/dictionary of network interfaces for the VM. O(net='{"key":"value", "key":"value"}').
- Keys allowed are - C(net[n]) where 0 n N.
- Values allowed are - C("model="XX:XX:XX:XX:XX:XX",bridge="value",rate="value",tag="value",firewall="1|0",trunks="vlanid"").
- Model is one of C(e1000 e1000-82540em e1000-82544gc e1000-82545em i82551 i82557b i82559er ne2k_isa ne2k_pci pcnet rtl8139 virtio vmxnet3).
- Model is one of C(e1000 e1000-82540em e1000-82544gc e1000-82545em i82551 i82557b i82559er ne2k_isa ne2k_pci pcnet
rtl8139 virtio vmxnet3).
- C(XX:XX:XX:XX:XX:XX) should be an unique MAC address. This is automatically generated if not specified.
- The C(bridge) parameter can be used to automatically add the interface to a bridge device. The Proxmox VE standard bridge is called 'vmbr0'.
- Option C(rate) is used to limit traffic bandwidth from and to this interface. It is specified as floating point number, unit is 'Megabytes
per second'.
- The C(bridge) parameter can be used to automatically add the interface to a bridge device. The Proxmox VE standard
bridge is called 'vmbr0'.
- Option C(rate) is used to limit traffic bandwidth from and to this interface. It is specified as floating point number,
unit is 'Megabytes per second'.
- If you specify no bridge, we create a kvm 'user' (NATed) network device, which provides DHCP and DNS services.
type: dict
newid:
@ -361,9 +367,9 @@ options:
- Values allowed are - C("storage:size,format=value").
- C(storage) is the storage identifier where to create the disk.
- C(size) is the size of the disk in GB.
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
supported by the provided storage backend.
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
tables 3 to 14) to find out format supported by the provided storage backend.
type: dict
scsi:
description:
@ -372,9 +378,9 @@ options:
- Values allowed are - C("storage:size,format=value").
- C(storage) is the storage identifier where to create the disk.
- C(size) is the size of the disk in GB.
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
supported by the provided storage backend.
- C(format) is the drive's backing file's data format. C(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
tables 3 to 14) to find out format supported by the provided storage backend.
type: dict
scsihw:
description:
@ -393,7 +399,8 @@ options:
- A hash/dictionary of serial device to create inside the VM. V('{"key":"value", "key":"value"}').
- Keys allowed are - serial[n](str; required) where 0 n 3.
- Values allowed are - V((/dev/.+|socket\)).
- /!\ If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.
- /!\ If you pass through a host serial device, it is no longer possible to migrate such machines - use with special
care.
type: dict
shares:
description:
@ -483,7 +490,8 @@ options:
timeout:
description:
- Timeout for operations.
- When used with O(state=stopped) the option sets a graceful timeout for VM stop after which a VM will be forcefully stopped.
- When used with O(state=stopped) the option sets a graceful timeout for VM stop after which a VM will be forcefully
stopped.
type: int
default: 30
tpmstate0:
@ -517,16 +525,17 @@ options:
update:
description:
- If V(true), the VM will be updated with new value.
- Because of the operations of the API and security reasons, I have disabled the update of the following parameters O(net), O(virtio), O(ide),
O(sata), O(scsi). Per example updating O(net) update the MAC address and O(virtio) create always new disk... This security feature can
be disabled by setting the O(update_unsafe) to V(true).
- Because of the operations of the API and security reasons, I have disabled the update of the following parameters
O(net), O(virtio), O(ide), O(sata), O(scsi). Per example updating O(net) update the MAC address and O(virtio) create
always new disk... This security feature can be disabled by setting the O(update_unsafe) to V(true).
- Update of O(pool) is disabled. It needs an additional API endpoint not covered by this module.
type: bool
default: false
update_unsafe:
description:
- If V(true), do not enforce limitations on parameters O(net), O(virtio), O(ide), O(sata), O(scsi), O(efidisk0), and O(tpmstate0). Use this
option with caution because an improper configuration might result in a permanent loss of data (for example disk recreated).
- If V(true), do not enforce limitations on parameters O(net), O(virtio), O(ide), O(sata), O(scsi), O(efidisk0), and
O(tpmstate0). Use this option with caution because an improper configuration might result in a permanent loss of data
(for example disk recreated).
type: bool
default: false
version_added: 8.4.0
@ -546,9 +555,9 @@ options:
- Values allowed are - V(storage:size,format=value).
- V(storage) is the storage identifier where to create the disk.
- V(size) is the size of the disk in GB.
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator Guide, section
Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version, tables 3 to 14) to find out format
supported by the provided storage backend.
- V(format) is the drive's backing file's data format. V(qcow2|raw|subvol). Please refer to the Proxmox VE Administrator
Guide, section Proxmox VE Storage (see U(https://pve.proxmox.com/pve-docs/chapter-pvesm.html) for the latest version,
tables 3 to 14) to find out format supported by the provided storage backend.
type: dict
watchdog:
description:

View File

@ -51,8 +51,8 @@ options:
description:
- The NIC emulator model.
type: str
choices: ['e1000', 'e1000-82540em', 'e1000-82544gc', 'e1000-82545em', 'i82551', 'i82557b', 'i82559er', 'ne2k_isa', 'ne2k_pci', 'pcnet', 'rtl8139',
'virtio', 'vmxnet3']
choices: ['e1000', 'e1000-82540em', 'e1000-82544gc', 'e1000-82545em', 'i82551', 'i82557b', 'i82559er', 'ne2k_isa', 'ne2k_pci',
'pcnet', 'rtl8139', 'virtio', 'vmxnet3']
default: virtio
mtu:
description:

View File

@ -29,7 +29,7 @@ options:
type: str
vmid:
description:
- The instance id.
- The instance ID.
- If not set, will be fetched from PromoxAPI based on the hostname.
type: str
state:
@ -50,8 +50,8 @@ options:
- Allows to snapshot a container even if it has configured mountpoints.
- Temporarily disables all configured mountpoints, takes snapshot, and finally restores original configuration.
- If running, the container will be stopped and restarted to apply config changes.
- Due to restrictions in the Proxmox API this option can only be used authenticating as V(root@pam) with O(api_password), API tokens do
not work either.
- Due to restrictions in the Proxmox API this option can only be used authenticating as V(root@pam) with O(api_password),
API tokens do not work either.
- See U(https://pve.proxmox.com/pve-docs/api-viewer/#/nodes/{node}/lxc/{vmid}/config) (PUT tab) for more details.
default: false
type: bool
@ -80,8 +80,8 @@ options:
description:
- Remove old snapshots if there are more than O(retention) snapshots.
- If O(retention) is set to V(0), all snapshots will be kept.
- This is only used when O(state=present) and when an actual snapshot is created. If no snapshot is created, all existing snapshots will
be kept.
- This is only used when O(state=present) and when an actual snapshot is created. If no snapshot is created, all existing
snapshots will be kept.
default: 0
type: int
version_added: 7.1.0

View File

@ -18,8 +18,8 @@ DOCUMENTATION = r"""
module: pubnub_blocks
short_description: PubNub blocks management module
description:
- 'This module allows Ansible to interface with the PubNub BLOCKS infrastructure by providing the following operations: create / remove, start
/ stop and rename for blocks and create / modify / remove for event handlers.'
- 'This module allows Ansible to interface with the PubNub BLOCKS infrastructure by providing the following operations:
create / remove, start / stop and rename for blocks and create / modify / remove for event handlers.'
author:
- PubNub <support@pubnub.com> (@pubnub)
- Sergey Mamontov <sergey@pubnub.com> (@parfeon)
@ -49,8 +49,8 @@ options:
default: ''
cache:
description: >-
In case if single play use blocks management module few times it is preferred to enabled 'caching' by making previous module to share gathered
artifacts and pass them to this parameter.
In case if single play use blocks management module few times it is preferred to enabled 'caching' by making previous
module to share gathered artifacts and pass them to this parameter.
required: false
type: dict
default: {}
@ -84,22 +84,22 @@ options:
type: str
description:
description:
- Short block description which will be later visible on admin.pubnub.com. Used only if block doesn't exists and won't change description
for existing block.
- Short block description which will be later visible on U(https://admin.pubnub.com).
- Used only if block does not exists and does not change description for existing block.
required: false
type: str
event_handlers:
description:
- List of event handlers which should be updated for specified block O(name).
- 'Each entry for new event handler should contain: V(name), V(src), V(channels), V(event). V(name) used as event handler name which can
be used later to make changes to it.'
- 'Each entry for new event handler should contain: V(name), V(src), V(channels), V(event). V(name) used as event handler
name which can be used later to make changes to it.'
- C(src) is full path to file with event handler code.
- V(channels) is name of channel from which event handler is waiting for events.
- 'V(event) is type of event which is able to trigger event handler: V(js-before-publish), V(js-after-publish), V(js-after-presence).'
- Each entry for existing handlers should contain C(name) (so target handler can be identified). Rest parameters (C(src), C(channels) and
C(event)) can be added if changes required for them.
- It is possible to rename event handler by adding C(changes) key to event handler payload and pass dictionary, which will contain single
key C(name), where new name should be passed.
- Each entry for existing handlers should contain C(name) (so target handler can be identified). Rest parameters (C(src),
C(channels) and C(event)) can be added if changes required for them.
- It is possible to rename event handler by adding C(changes) key to event handler payload and pass dictionary, which
will contain single key C(name), where new name should be passed.
- To remove particular event handler it is possible to set C(state) for it to C(absent) and it will be removed.
required: false
default: []
@ -114,8 +114,8 @@ options:
type: dict
validate_certs:
description:
- This key allow to try skip certificates check when performing REST API calls. Sometimes host may have issues with certificates on it and
this will cause problems to call PubNub REST API.
- This key allow to try skip certificates check when performing REST API calls. Sometimes host may have issues with
certificates on it and this will cause problems to call PubNub REST API.
- If check should be ignored V(false) should be passed to this parameter.
required: false
default: true
@ -208,8 +208,8 @@ EXAMPLES = r"""
RETURN = r"""
module_cache:
description:
- Cached account information. In case if with single play module used few times it is better to pass cached data to next module calls to speed
up process.
- Cached account information. In case if with single play module used few times it is better to pass cached data to next
module calls to speed up process.
type: dict
returned: always
"""

View File

@ -34,9 +34,9 @@ options:
type: str
force_basic_auth:
description:
- C(httplib2), the library used by the M(ansible.builtin.uri) module only sends authentication information when a webservice responds to an
initial request with a 401 status. Since some basic auth services do not properly send a 401, logins will fail. This option forces the
sending of the Basic authentication header upon initial request.
- C(httplib2), the library used by the M(ansible.builtin.uri) module only sends authentication information when a webservice
responds to an initial request with a 401 status. Since some basic auth services do not properly send a 401, logins
will fail. This option forces the sending of the Basic authentication header upon initial request.
type: bool
default: false
generate_sqlite:
@ -47,20 +47,22 @@ options:
default: false
feed_ca_cert:
description:
- CA certificate string used to validate the feed source SSL certificate. This can be the file content or the path to the file.
- CA certificate string used to validate the feed source SSL certificate. This can be the file content or the path to
the file.
type: str
aliases: [importer_ssl_ca_cert]
feed_client_cert:
description:
- Certificate used as the client certificate when synchronizing the repository. This is used to communicate authentication information to
the feed source. The value to this option must be the full path to the certificate. The specified file may be the certificate itself or
a single file containing both the certificate and private key. This can be the file content or the path to the file.
- Certificate used as the client certificate when synchronizing the repository. This is used to communicate authentication
information to the feed source. The value to this option must be the full path to the certificate. The specified file
may be the certificate itself or a single file containing both the certificate and private key. This can be the file
content or the path to the file.
type: str
aliases: [importer_ssl_client_cert]
feed_client_key:
description:
- Private key to the certificate specified in O(feed_client_cert), assuming it is not included in the certificate file itself. This can
be the file content or the path to the file.
- Private key to the certificate specified in O(feed_client_cert), assuming it is not included in the certificate file
itself. This can be the file content or the path to the file.
type: str
aliases: [importer_ssl_client_key]
name:
@ -71,7 +73,7 @@ options:
aliases: [repo]
proxy_host:
description:
- Proxy url setting for the pulp repository importer. This is in the format scheme://host.
- Proxy URL setting for the pulp repository importer. This is in the format V(scheme://host).
required: false
default:
type: str
@ -129,21 +131,22 @@ options:
default: true
state:
description:
- The repo state. A state of V(sync) will queue a sync of the repo. This is asynchronous but not delayed like a scheduled sync. A state
of V(publish) will use the repository's distributor to publish the content.
- The repo state. A state of V(sync) will queue a sync of the repo. This is asynchronous but not delayed like a scheduled
sync. A state of V(publish) will use the repository's distributor to publish the content.
default: present
choices: ["present", "absent", "sync", "publish"]
type: str
url_password:
description:
- The password for use in HTTP basic authentication to the pulp API. If the O(url_username) parameter is not specified, the O(url_password)
parameter will not be used.
- The password for use in HTTP basic authentication to the pulp API. If the O(url_username) parameter is not specified,
the O(url_password) parameter will not be used.
url_username:
description:
- The username for use in HTTP basic authentication to the pulp API.
validate_certs:
description:
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using
self-signed certificates.
type: bool
default: true
wait_for_completion:
@ -152,7 +155,8 @@ options:
type: bool
default: false
notes:
- This module can currently only create distributors and importers on rpm repositories. Contributions to support other repo types are welcome.
- This module can currently only create distributors and importers on rpm repositories. Contributions to support other repo
types are welcome.
extends_documentation_fragment:
- ansible.builtin.url
- community.general.attributes

View File

@ -103,7 +103,8 @@ options:
waitforlock:
description:
- The maximum amount of time C(puppet) should wait for an already running C(puppet) agent to finish before starting.
- If a number without unit is provided, it is assumed to be a number of seconds. Allowed units are V(m) for minutes and V(h) for hours.
- If a number without unit is provided, it is assumed to be a number of seconds. Allowed units are V(m) for minutes
and V(h) for hours.
type: str
version_added: 9.0.0
verbose:
@ -125,10 +126,10 @@ options:
description:
- The lang environment to use when running the puppet agent.
- The default value, V(C), is supported on every system, but can lead to encoding errors if UTF-8 is used in the output.
- Use V(C.UTF-8) or V(en_US.UTF-8) or similar UTF-8 supporting locales in case of problems. You need to make sure the selected locale is
supported on the system the puppet agent runs on.
- Starting with community.general 9.1.0, you can use the value V(auto) and the module will try and determine the best parseable locale to
use.
- Use V(C.UTF-8) or V(en_US.UTF-8) or similar UTF-8 supporting locales in case of problems. You need to make sure the
selected locale is supported on the system the puppet agent runs on.
- Starting with community.general 9.1.0, you can use the value V(auto) and the module will try and determine the best
parseable locale to use.
type: str
default: C
version_added: 8.6.0

View File

@ -32,7 +32,8 @@ options:
channel:
type: str
description:
- The channel TAG you wish to broadcast a push notification, as seen on the "My Channels" > "Edit your channel" at Pushbullet page.
- The channel TAG you wish to broadcast a push notification, as seen on the "My Channels" > "Edit your channel" at Pushbullet
page.
device:
type: str
description:

View File

@ -20,9 +20,10 @@ options:
type: list
elements: str
description:
- 'A list of version-likes or module names to check for installation. Supported operators: C(<), C(>), C(<=), C(>=), or C(==).'
- The bare module name like V(ansible), the module with a specific version like V(boto3==1.6.1),
or a partial version like V(requests>2) are all valid specifications.
- 'A list of version-likes or module names to check for installation. Supported operators: C(<), C(>), C(<=), C(>=),
or C(==).'
- The bare module name like V(ansible), the module with a specific version like V(boto3==1.6.1), or a partial version
like V(requests>2) are all valid specifications.
default: []
author:
- Will Thames (@willthames)
@ -90,8 +91,8 @@ python_system_path:
- /usr/local/opt/python@2/site-packages/
- /usr/lib/python/site-packages/
valid:
description: A dictionary of dependencies that matched their desired versions. If no version was specified, then RV(ignore:desired) will be
null.
description: A dictionary of dependencies that matched their desired versions. If no version was specified, then RV(ignore:desired)
will be V(null).
returned: always
type: dict
sample:

View File

@ -63,7 +63,8 @@ options:
aliases: [account_id]
description:
- ID of account to delete/modify.
- Can also be used in account creation to work around vendor issues where the ID of the new user is required in the POST request.
- Can also be used in account creation to work around vendor issues where the ID of the new user is required in the
POST request.
type: str
new_username:
required: false
@ -227,9 +228,9 @@ options:
description:
- Custom OEM properties for HTTP Multipart Push updates.
- If set, then O(update_custom_oem_header) is required too.
- The properties will be passed raw without any validation or conversion by Ansible. This means the content can be a file, a string, or
any other data. If the content is a dict that should be converted to JSON, then the content must be converted to JSON before passing it
to this module using the P(ansible.builtin.to_json#filter) filter.
- The properties will be passed raw without any validation or conversion by Ansible. This means the content can be a
file, a string, or any other data. If the content is a dict that should be converted to JSON, then the content must
be converted to JSON before passing it to this module using the P(ansible.builtin.to_json#filter) filter.
type: raw
version_added: '10.1.0'
update_custom_oem_mime_type:
@ -327,7 +328,8 @@ options:
description:
- SSL/TLS Ciphers to use for the request.
- When a list is provided, all ciphers are joined in order with V(:).
- See the L(OpenSSL Cipher List Format,https://www.openssl.org/docs/manmaster/man1/openssl-ciphers.html#CIPHER-LIST-FORMAT) for more details.
- See the L(OpenSSL Cipher List Format,https://www.openssl.org/docs/manmaster/man1/openssl-ciphers.html#CIPHER-LIST-FORMAT)
for more details.
- The available ciphers is dependent on the Python and OpenSSL/LibreSSL versions.
type: list
elements: str

View File

@ -136,7 +136,7 @@ options:
storage_subsystem_id:
required: false
description:
- Id of the Storage Subsystem on which the volume is to be created.
- ID of the Storage Subsystem on which the volume is to be created.
type: str
default: ''
version_added: '7.3.0'
@ -166,8 +166,8 @@ options:
required: false
description:
- Setting dict of volume to be created.
- If C(CapacityBytes) key is not specified in this dictionary, the size of the volume will be determined by the Redfish service. It is possible
the size will not be the maximum available size.
- If C(CapacityBytes) key is not specified in this dictionary, the size of the volume will be determined by the Redfish
service. It is possible the size will not be the maximum available size.
type: dict
default: {}
version_added: '7.5.0'
@ -176,7 +176,8 @@ options:
description:
- SSL/TLS Ciphers to use for the request.
- When a list is provided, all ciphers are joined in order with V(:).
- See the L(OpenSSL Cipher List Format,https://www.openssl.org/docs/manmaster/man1/openssl-ciphers.html#CIPHER-LIST-FORMAT) for more details.
- See the L(OpenSSL Cipher List Format,https://www.openssl.org/docs/manmaster/man1/openssl-ciphers.html#CIPHER-LIST-FORMAT)
for more details.
- The available ciphers is dependent on the Python and OpenSSL/LibreSSL versions.
type: list
elements: str

View File

@ -75,7 +75,8 @@ options:
description:
- SSL/TLS Ciphers to use for the request.
- When a list is provided, all ciphers are joined in order with V(:).
- See the L(OpenSSL Cipher List Format,https://www.openssl.org/docs/manmaster/man1/openssl-ciphers.html#CIPHER-LIST-FORMAT) for more details.
- See the L(OpenSSL Cipher List Format,https://www.openssl.org/docs/manmaster/man1/openssl-ciphers.html#CIPHER-LIST-FORMAT)
for more details.
- The available ciphers is dependent on the Python and OpenSSL/LibreSSL versions.
type: list
elements: str

View File

@ -14,32 +14,27 @@ DOCUMENTATION = r"""
module: redhat_subscription
short_description: Manage registration and subscriptions to RHSM using C(subscription-manager)
description:
- Manage registration and subscription to the Red Hat Subscription Management entitlement platform using the C(subscription-manager) command,
registering using D-Bus if possible.
- Manage registration and subscription to the Red Hat Subscription Management entitlement platform using the C(subscription-manager)
command, registering using D-Bus if possible.
author: "Barnaby Court (@barnabycourt)"
notes:
- >-
The module tries to use the D-Bus C(rhsm) service (part of C(subscription-manager))
to register, starting from community.general 6.5.0: this is done so credentials
(username, password, activation keys) can be passed to C(rhsm) in a secure way.
C(subscription-manager) itself gets credentials only as arguments of command line
parameters, which is I(not) secure, as they can be easily stolen by checking the
process listing on the system. Due to limitations of the D-Bus interface of C(rhsm),
the module will I(not) use D-Bus for registration when trying either to register
using O(token), or when specifying O(environment), or when the system is old
(typically RHEL 7 older than 7.4, RHEL 6, and older).
- In order to register a system, subscription-manager requires either a username and password, or an activationkey and an Organization ID.
- Since 2.5 values for O(server_hostname), O(server_insecure), O(rhsm_baseurl),
O(server_proxy_hostname), O(server_proxy_port), O(server_proxy_user) and
O(server_proxy_password) are no longer taken from the C(/etc/rhsm/rhsm.conf)
config file and default to V(null).
- It is possible to interact with C(subscription-manager) only as root,
so root permissions are required to successfully run this module.
- Since community.general 6.5.0, credentials (that is, O(username) and O(password),
O(activationkey), or O(token)) are needed only in case the the system is not registered,
or O(force_register) is specified; this makes it possible to use the module to tweak an
already registered system, for example attaching pools to it (using O(pool_ids)),
and modifying the C(syspurpose) attributes (using O(syspurpose)).
- 'The module tries to use the D-Bus C(rhsm) service (part of C(subscription-manager)) to register, starting from community.general
6.5.0: this is done so credentials (username, password, activation keys) can be passed to C(rhsm) in a secure way. C(subscription-manager)
itself gets credentials only as arguments of command line parameters, which is I(not) secure, as they can be easily stolen
by checking the process listing on the system. Due to limitations of the D-Bus interface of C(rhsm), the module will I(not)
use D-Bus for registration when trying either to register using O(token), or when specifying O(environment), or when the
system is old (typically RHEL 7 older than 7.4, RHEL 6, and older).'
- In order to register a system, subscription-manager requires either a username and password, or an activationkey and an
Organization ID.
- Since 2.5 values for O(server_hostname), O(server_insecure), O(rhsm_baseurl), O(server_proxy_hostname), O(server_proxy_port),
O(server_proxy_user) and O(server_proxy_password) are no longer taken from the C(/etc/rhsm/rhsm.conf) config file and
default to V(null).
- It is possible to interact with C(subscription-manager) only as root, so root permissions are required to successfully
run this module.
- Since community.general 6.5.0, credentials (that is, O(username) and O(password), O(activationkey), or O(token)) are needed
only in case the the system is not registered, or O(force_register) is specified; this makes it possible to use the module
to tweak an already registered system, for example attaching pools to it (using O(pool_ids)), and modifying the C(syspurpose)
attributes (using O(syspurpose)).
requirements:
- subscription-manager
- Optionally the C(dbus) Python library; this is usually included in the OS as it is used by C(subscription-manager).
@ -120,7 +115,7 @@ options:
auto_attach:
description:
- Upon successful registration, auto-consume available subscriptions.
- "Please note that the alias O(ignore:autosubscribe) was removed in community.general 9.0.0."
- Please note that the alias O(ignore:autosubscribe) was removed in community.general 9.0.0.
type: bool
activationkey:
description:
@ -136,10 +131,11 @@ options:
type: str
pool_ids:
description:
- "Specify subscription pool IDs to consume.
- A pool ID may be specified as a C(string) - just the pool ID (for example V(0123456789abcdef0123456789abcdef)),
or as a C(dict) with the pool ID as the key, and a quantity as the value (for example V(0123456789abcdef0123456789abcdef: 2). If the
quantity is provided, it is used to consume multiple entitlements from a pool (the pool must support this)."
- Specify subscription pool IDs to consume.
- 'A pool ID may be specified as a C(string) - just the pool ID (for example
V(0123456789abcdef0123456789abcdef)), or as a C(dict) with the pool ID as the key, and a quantity as the value (for
example V(0123456789abcdef0123456789abcdef: 2). If the quantity is provided, it is used to consume multiple entitlements
from a pool (the pool must support this).'
default: []
type: list
elements: raw
@ -153,9 +149,9 @@ options:
type: str
consumer_id:
description:
- "References an existing consumer ID to resume using a previous registration for this system. If the system's identity certificate is
lost or corrupted, this option allows it to resume using its previous identity and subscriptions. The default is to not specify a consumer
ID so a new ID is created."
- References an existing consumer ID to resume using a previous registration for this system. If the system's identity
certificate is lost or corrupted, this option allows it to resume using its previous identity and subscriptions. The
default is to not specify a consumer ID so a new ID is created.
type: str
force_register:
description:
@ -168,10 +164,11 @@ options:
type: str
syspurpose:
description:
- Set syspurpose attributes in file C(/etc/rhsm/syspurpose/syspurpose.json) and synchronize these attributes with RHSM server. Syspurpose
attributes help attach the most appropriate subscriptions to the system automatically. When C(syspurpose.json) file already contains some
attributes, then new attributes overwrite existing attributes. When some attribute is not listed in the new list of attributes, the existing
attribute will be removed from C(syspurpose.json) file. Unknown attributes are ignored.
- Set syspurpose attributes in file C(/etc/rhsm/syspurpose/syspurpose.json) and synchronize these attributes with RHSM
server. Syspurpose attributes help attach the most appropriate subscriptions to the system automatically. When C(syspurpose.json)
file already contains some attributes, then new attributes overwrite existing attributes. When some attribute is not
listed in the new list of attributes, the existing attribute will be removed from C(syspurpose.json) file. Unknown
attributes are ignored.
type: dict
suboptions:
usage:
@ -189,8 +186,8 @@ options:
elements: str
sync:
description:
- When this option is V(true), then syspurpose attributes are synchronized with RHSM server immediately. When this option is V(false),
then syspurpose attributes will be synchronized with RHSM server by rhsmcertd daemon.
- When this option is V(true), then syspurpose attributes are synchronized with RHSM server immediately. When this
option is V(false), then syspurpose attributes will be synchronized with RHSM server by rhsmcertd daemon.
type: bool
default: false
"""

View File

@ -72,14 +72,15 @@ options:
type: str
value:
description:
- A redis config value. When memory size is needed, it is possible to specify it in the usual form of 1KB, 2M, 400MB where the base is 1024.
Units are case insensitive, in other words 1m = 1mb = 1M = 1MB.
- A redis config value. When memory size is needed, it is possible to specify it in the usual form of 1KB, 2M, 400MB
where the base is 1024. Units are case insensitive, in other words 1m = 1mb = 1M = 1MB.
type: str
notes:
- Requires the C(redis-py) Python package on the remote host. You can install it with pip
(C(pip install redis)) or with a package manager. U(https://github.com/andymccurdy/redis-py).
- If the redis master instance you are making replica of is password protected this needs to be in the C(redis.conf) in the C(masterauth) variable.
- Requires the C(redis-py) Python package on the remote host. You can install it with pip (C(pip install redis)) or with
a package manager. U(https://github.com/andymccurdy/redis-py).
- If the redis master instance you are making replica of is password protected this needs to be in the C(redis.conf) in
the C(masterauth) variable.
seealso:
- module: community.general.redis_info
requirements: [redis]

View File

@ -20,10 +20,10 @@ attributes:
check_mode:
support: partial
details:
- For C(check_mode) to work, the specified O(login_user) needs permission to run the C(GET) command on the key, otherwise the module will
fail.
- When using C(check_mode) the module will try to calculate the value that Redis would return. If the key is not present, V(0.0) is used as
value.
- For C(check_mode) to work, the specified O(login_user) needs permission to run the C(GET) command on the key, otherwise
the module will fail.
- When using C(check_mode) the module will try to calculate the value that Redis would return. If the key is not present,
V(0.0) is used as value.
diff_mode:
support: none
options:

View File

@ -14,9 +14,10 @@ short_description: Set or Unset RHSM Release version
description:
- Sets or unsets the release version used by RHSM repositories.
notes:
- This module will fail on an unregistered system. Use the M(community.general.redhat_subscription) module to register a system prior to setting
the RHSM release.
- It is possible to interact with C(subscription-manager) only as root, so root permissions are required to successfully run this module.
- This module will fail on an unregistered system. Use the M(community.general.redhat_subscription) module to register a
system prior to setting the RHSM release.
- It is possible to interact with C(subscription-manager) only as root, so root permissions are required to successfully
run this module.
requirements:
- Red Hat Enterprise Linux 6+ with subscription-manager installed
extends_documentation_fragment:

View File

@ -12,12 +12,14 @@ DOCUMENTATION = r"""
module: rhsm_repository
short_description: Manage RHSM repositories using the subscription-manager command
description:
- Manage (Enable/Disable) RHSM repositories to the Red Hat Subscription Management entitlement platform using the C(subscription-manager) command.
- Manage (Enable/Disable) RHSM repositories to the Red Hat Subscription Management entitlement platform using the C(subscription-manager)
command.
author: Giovanni Sciortino (@giovannisciortino)
notes:
- In order to manage RHSM repositories the system must be already registered to RHSM manually or using the Ansible M(community.general.redhat_subscription)
module.
- It is possible to interact with C(subscription-manager) only as root, so root permissions are required to successfully run this module.
- It is possible to interact with C(subscription-manager) only as root, so root permissions are required to successfully
run this module.
requirements:
- subscription-manager
extends_documentation_fragment:
@ -31,7 +33,8 @@ options:
state:
description:
- If state is equal to present or disabled, indicates the desired repository state.
- In community.general 10.0.0 the states V(present) and V(absent) have been removed. Please use V(enabled) and V(disabled) instead.
- In community.general 10.0.0 the states V(present) and V(absent) have been removed. Please use V(enabled) and V(disabled)
instead.
choices: [enabled, disabled]
default: "enabled"
type: str
@ -44,8 +47,8 @@ options:
elements: str
purge:
description:
- Disable all currently enabled repositories that are not not specified in O(name). Only set this to V(true) if passing in a list of repositories
to the O(name) field. Using this with C(loop) will most likely not have the desired result.
- Disable all currently enabled repositories that are not not specified in O(name). Only set this to V(true) if passing
in a list of repositories to the O(name) field. Using this with C(loop) will most likely not have the desired result.
type: bool
default: false
"""

View File

@ -62,7 +62,8 @@ options:
type: str
validate_certs:
description:
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using
self-signed certificates.
type: bool
default: true
"""

View File

@ -34,7 +34,8 @@ options:
token:
type: str
description:
- Rocket Chat Incoming Webhook integration token. This provides authentication to Rocket Chat's Incoming webhook for posting messages.
- Rocket Chat Incoming Webhook integration token. This provides authentication to Rocket Chat's Incoming webhook for
posting messages.
required: true
protocol:
type: str
@ -51,8 +52,8 @@ options:
channel:
type: str
description:
- Channel to send the message to. If absent, the message goes to the channel selected for the O(token) specified during the creation of
webhook.
- Channel to send the message to. If absent, the message goes to the channel selected for the O(token) specified during
the creation of webhook.
username:
type: str
description:
@ -79,13 +80,15 @@ options:
- 0
validate_certs:
description:
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.
- If V(false), SSL certificates will not be validated. This should only be used on personally controlled sites using
self-signed certificates.
type: bool
default: true
color:
type: str
description:
- Allow text to use default colors - use the default of V(normal) to not send a custom color bar at the start of the message.
- Allow text to use default colors - use the default of V(normal) to not send a custom color bar at the start of the
message.
default: 'normal'
choices:
- 'normal'
@ -118,7 +121,8 @@ EXAMPLES = r"""
link_names: 0
delegate_to: localhost
- name: Insert a color bar in front of the message for visibility purposes and use the default webhook icon and name configured in rocketchat
- name: Insert a color bar in front of the message for visibility purposes and use the default webhook icon and name configured
in rocketchat
community.general.rocketchat:
token: thetoken/generatedby/rocketchat
domain: chat.example.com

View File

@ -61,8 +61,8 @@ options:
default: 'https://api.rollbar.com/api/1/deploy/'
validate_certs:
description:
- If V(false), SSL certificates for the target url will not be validated. This should only be used on personally controlled sites using
self-signed certificates.
- If V(false), SSL certificates for the target URL will not be validated. This should only be used on personally controlled
sites using self-signed certificates.
required: false
default: true
type: bool

View File

@ -30,9 +30,9 @@ options:
required: true
state:
description:
- V(started)/V(stopped) are idempotent actions that will not run commands unless necessary. V(restarted) will always bounce the service
(sv restart) and V(killed) will always bounce the service (sv force-stop). V(reloaded) will send a HUP (sv reload). V(once) will run a
normally downed sv once (sv once), not really an idempotent operation.
- V(started)/V(stopped) are idempotent actions that will not run commands unless necessary. V(restarted) will always
bounce the service (sv restart) and V(killed) will always bounce the service (sv force-stop). V(reloaded) will send
a HUP (sv reload). V(once) will run a normally downed sv once (sv once), not really an idempotent operation.
type: str
choices: [killed, once, reloaded, restarted, started, stopped]
enabled: